@senpi/runtime 1.1.0-dev.runtime-phase-2.20260610125851 → 1.1.0-dev.runtime-phase-2.20260610130051

package/dist/recording/wiring/emitter-factory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Construct the recording emitter at boot. Telemetry is ON by default; it degrades to the inert
+ * {@link NoopEmitter} when explicitly disabled or when no API token is available — a missing token
+ * is never a boot failure. When live, an {@link OtelEmitter} feeds a {@link TelemetryBatcher} that
+ * must be shut down on stop.
+ */
+import type { IdentityEnvelope } from "../identity.js";
+import type { RecordingEmitter } from "../emitter.js";
+import { type TelemetryBatcher } from "../transport/index.js";
+export interface RecordingEmitterOptions {
+    /** Resolved enable flag (config + env already applied by the caller). */
+    readonly enabled: boolean;
+    /** Bearer token (the `SENPI_API_KEY` JWT); absent → degrade to Noop. */
+    readonly token?: string;
+    /** Built lazily — only invoked on the live path, so the config canonicalize + hash is never
+     * computed for a noop emitter. */
+    readonly identity: () => IdentityEnvelope;
+    /** Emitter scope version — the real package version, wired at boot. */
+    readonly scopeVersion: string;
+    /** Ingestion base URL override (else env / default, resolved by the transport). */
+    readonly baseUrl?: string;
+    readonly flushIntervalMs?: number;
+}
+export interface RecordingComponents {
+    readonly emitter: RecordingEmitter;
+    /** The batcher to flush/stop on shutdown; `null` when the emitter is a Noop. */
+    readonly batcher: TelemetryBatcher | null;
+}
+/**
+ * Build the emitter + (optional) batcher. Never throws: any construction error degrades to Noop so
+ * telemetry can never block boot.
+ */
+export declare function createRecordingComponents(options: RecordingEmitterOptions): RecordingComponents;
+/**
+ * Resolve the enable flag: explicit env override wins, else the recipe's `telemetry.enabled`, else
+ * the default (`true`). Recognized env truthy/falsy spellings keep an ops override unambiguous.
+ */
+export declare function resolveTelemetryEnabled(configEnabled: boolean | undefined, envValue: string | undefined): boolean;
+//# sourceMappingURL=emitter-factory.d.ts.map

package/dist/recording/wiring/emitter-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter-factory.d.ts","sourceRoot":"","sources":["../../../src/recording/wiring/emitter-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKrG,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;sCACkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,uBAAuB,GAAG,mBAAmB,CA+B/F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,OAAO,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAWT"}

package/dist/recording/wiring/emitter-factory.js

@@ -0,0 +1,62 @@
+/**
+ * Construct the recording emitter at boot. Telemetry is ON by default; it degrades to the inert
+ * {@link NoopEmitter} when explicitly disabled or when no API token is available — a missing token
+ * is never a boot failure. When live, an {@link OtelEmitter} feeds a {@link TelemetryBatcher} that
+ * must be shut down on stop.
+ */
+import { noopEmitter } from "../noop-emitter.js";
+import { OtelEmitter } from "../otel/index.js";
+import { createBatcher, resolveTransportConfig } from "../transport/index.js";
+import { createLogger } from "../../utils/logger.js";
+const logger = createLogger("[recording][wiring]");
+/**
+ * Build the emitter + (optional) batcher. Never throws: any construction error degrades to Noop so
+ * telemetry can never block boot.
+ */
+export function createRecordingComponents(options) {
+    if (!options.enabled) {
+        logger.info("telemetry recording disabled by config/env; using noop emitter");
+        return { emitter: noopEmitter, batcher: null };
+    }
+    const token = options.token;
+    if (!token) {
+        logger.warn("telemetry recording enabled but no SENPI_API_KEY available; degrading to noop emitter (no telemetry will be shipped)");
+        return { emitter: noopEmitter, batcher: null };
+    }
+    try {
+        const identity = options.identity();
+        const batcher = createBatcher(resolveTransportConfig({
+            getToken: () => token,
+            baseUrl: options.baseUrl,
+            flushIntervalMs: options.flushIntervalMs,
+        }));
+        const emitter = new OtelEmitter(identity, batcher, { scopeVersion: options.scopeVersion });
+        logger.info("telemetry recording enabled", { service: identity.service });
+        return { emitter, batcher };
+    }
+    catch (err) {
+        logger.warn("failed to construct telemetry emitter; degrading to noop", {
+            err: err instanceof Error ? err.message : String(err),
+        });
+        return { emitter: noopEmitter, batcher: null };
+    }
+}
+/**
+ * Resolve the enable flag: explicit env override wins, else the recipe's `telemetry.enabled`, else
+ * the default (`true`). Recognized env truthy/falsy spellings keep an ops override unambiguous.
+ */
+export function resolveTelemetryEnabled(configEnabled, envValue) {
+    const env = envValue?.trim().toLowerCase();
+    if (env === "false" || env === "0" || env === "no" || env === "off")
+        return false;
+    if (env === "true" || env === "1" || env === "yes" || env === "on")
+        return true;
+    if (env !== undefined && env !== "") {
+        // Telemetry is on by default, so a typo'd opt-out must not be silent.
+        logger.warn("unrecognized SENPI_TELEMETRY_ENABLED value; ignoring (use true/false/1/0/yes/no/on/off)", {
+            value: envValue,
+        });
+    }
+    return configEnabled ?? true;
+}
+//# sourceMappingURL=emitter-factory.js.map

package/dist/recording/wiring/emitter-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter-factory.js","sourceRoot":"","sources":["../../../src/recording/wiring/emitter-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAyB,MAAM,uBAAuB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAuBnD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgC;IACxE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAC9E,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CACT,sHAAsH,CACvH,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,aAAa,CAC3B,sBAAsB,CAAC;YACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CACH,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,0DAA0D,EAAE;YACtE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACtD,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAAkC,EAClC,QAA4B;IAE5B,MAAM,GAAG,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClF,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,sEAAsE;QACtE,MAAM,CAAC,IAAI,CAAC,yFAAyF,EAAE;YACrG,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,aAAa,IAAI,IAAI,CAAC;AAC/B,CAAC"}

package/dist/recording/wiring/identity.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Build the {@link IdentityEnvelope} and the config fingerprint stamped on every recorded row.
+ *
+ * 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 type { IdentityEnvelope } from "../identity.js";
+/** Logical producer name stamped as `service.name` on every row. 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;
+    /** 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/recording/wiring/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/recording/wiring/identity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;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,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,CAU3E"}

package/dist/recording/wiring/identity.js

@@ -0,0 +1,51 @@
+/**
+ * Build the {@link IdentityEnvelope} and the config fingerprint stamped on every recorded row.
+ *
+ * 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`:
+ * 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";
+/**
+ * Canonical JSON with recursively sorted object keys, so two structurally-equal configs serialize
+ * identically regardless of key order. Arrays keep their order (order is meaningful there).
+ */
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === "object") {
+        const obj = value;
+        const out = {};
+        for (const key of Object.keys(obj).sort())
+            out[key] = canonicalize(obj[key]);
+        return out;
+    }
+    return value;
+}
+/** SHA-256 hex of the canonicalized unresolved config; `undefined` when no config is available. */
+export function computeConfigHash(unresolvedConfig) {
+    if (!unresolvedConfig)
+        return undefined;
+    try {
+        return createHash("sha256").update(JSON.stringify(canonicalize(unresolvedConfig))).digest("hex");
+    }
+    catch {
+        return undefined;
+    }
+}
+export function buildIdentity(params) {
+    return {
+        service: SERVICE_NAME,
+        recipe: params.name,
+        recipeVersion: params.recipeVersion,
+        runtime: params.name,
+        strategyAddress: params.strategyAddress,
+        bootId: params.bootId,
+        configHash: computeConfigHash(params.unresolvedConfig),
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/recording/wiring/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/recording/wiring/identity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;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;AAcD,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,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/recording/wiring/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `src/recording/wiring/` — the integration seam between the trading runtime and the recording
+ * emitter: build the identity/emitter at boot, subscribe to the `SenpiEventBus`, and turn events
+ * into records. Pure consumer; no producer change.
+ */
+export { buildIdentity, computeConfigHash, SERVICE_NAME } from "./identity.js";
+export type { BuildIdentityParams } from "./identity.js";
+export { createRecordingComponents, resolveTelemetryEnabled } from "./emitter-factory.js";
+export type { RecordingComponents, RecordingEmitterOptions } from "./emitter-factory.js";
+export { createRecordingSubscriber } from "./subscriber.js";
+export type { RecordingSubscriber, RecordingSubscriberDeps } from "./subscriber.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recording/wiring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recording/wiring/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/recording/wiring/index.js

@@ -0,0 +1,9 @@
+/**
+ * `src/recording/wiring/` — the integration seam between the trading runtime and the recording
+ * emitter: build the identity/emitter at boot, subscribe to the `SenpiEventBus`, and turn events
+ * into records. Pure consumer; no producer change.
+ */
+export { buildIdentity, computeConfigHash, SERVICE_NAME } from "./identity.js";
+export { createRecordingComponents, resolveTelemetryEnabled } from "./emitter-factory.js";
+export { createRecordingSubscriber } from "./subscriber.js";
+//# sourceMappingURL=index.js.map

package/dist/recording/wiring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recording/wiring/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/E,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/recording/wiring/record-builders.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pure builders: bus-event payloads → recording records. No I/O, no emitter — each function reads a
+ * loosely-typed payload defensively and returns a fully-populated record (or `null` when the event
+ * cannot yield one). Redaction is NOT done here — records are populated faithfully; the mapper is the
+ * single redaction seam.
+ *
+ * Timestamps: the bus carries ISO strings (and, for a scan result, an epoch-ms number); every record
+ * stores epoch ms, converted once here.
+ */
+import type { DslTransitionKind, DslTransitionRecord, PositionLifecycleEvent, PositionLifecycleRecord, RuntimeErrorRecord, RuntimeLifecycleRecord, RuntimeStateRecord, ScannerRunRecord, SignalDecision, SignalEvaluatedRecord, SignalSummary } from "../records.js";
+/** From a `tracking.scanner_run` / `tracking.scanner_run_skipped` / `tracking.scanner_run_error`
+ * event (complete runs carry the whole `ScanResult`; skip/error carry status + reason). */
+export declare function buildScannerRun(payload: unknown, nowMs: number): ScannerRunRecord | null;
+/** Pass-level decision state held between `tracking.decision` and its `tracking.action_result`. */
+export interface PendingDecision {
+    readonly scannerId?: string;
+    readonly startedAtMs: number;
+    readonly decision: SignalDecision;
+    readonly signals: readonly SignalSummary[];
+}
+/** Build the pending decision from a `tracking.decision` payload. */
+export declare function buildPendingDecision(payload: unknown, nowMs: number): PendingDecision | null;
+/**
+ * Pair a held {@link PendingDecision} with its `tracking.action_result` payload into one record.
+ * `evaluations` is one entry per per-signal result, each enriched with the matching input signal.
+ * The pass span runs decision-ts → action_result-ts; on clock skew (`endedAt < startedAt`) the start
+ * is pulled up to `endedAt`, yielding a zero (never negative) duration.
+ */
+export declare function buildSignalEvaluated(pending: PendingDecision, actionResultPayload: unknown, nowMs: number): SignalEvaluatedRecord;
+/**
+ * A `tracking.action_result` with no held decision — a producer that never emits `tracking.decision`
+ * for the pass (e.g. close-position's static-params path, `decision_mode: 'none'` + `params.asset`).
+ * The record carries the per-signal outcomes with signals synthesized from the result entries and no
+ * `decision` (the contract allows a decision-less pass); zero duration (`startedAt = endedAt` = the
+ * action_result timestamp).
+ */
+export declare function buildResultOnlyEvaluated(actionResultPayload: unknown, nowMs: number): SignalEvaluatedRecord | null;
+/**
+ * A decision that never received its action_result (the action threw or returned before emitting
+ * one). Flushed when the same action's next decision arrives, so a decided-but-unresulted pass is
+ * visible on the signal axis rather than silently dropped: no evaluations, zero duration
+ * (`startedAt = endedAt =` the decision timestamp).
+ */
+export declare function buildDecisionOnlyEvaluated(pending: PendingDecision): SignalEvaluatedRecord;
+/**
+ * From an `on_position_*` event. Action-driven events arrive as HookEvents (fields under a `data`
+ * envelope); the DSL monitor / reconcile paths emit `on_position_closed` flat (fields at the root,
+ * always with an `asset`), so a flat payload carrying an `asset` is read as-is. The DSL archive
+ * handler's re-broadcast of a close is marked `source: "dsl_archive"` and skipped — the close it
+ * mirrors was already recorded from the original emit. (`on_open_order_submitted` is deliberately
+ * not recorded — its submit fact is already on the signal-evaluation view, avoiding a double count.)
+ */
+export declare function buildPositionLifecycle(event: PositionLifecycleEvent, payload: unknown, nowMs: number): PositionLifecycleRecord | null;
+/** From a `dsl.*` event (fields live at the payload root, with an ISO `timestamp`). */
+export declare function buildDslTransition(transition: DslTransitionKind, payload: unknown, nowMs: number): DslTransitionRecord | null;
+/** From `signal_processing_error` — a bucket-2 error with no specific domain record home. */
+export declare function buildRuntimeError(payload: unknown, nowMs: number): RuntimeErrorRecord | null;
+/**
+ * From `tracking.runtime_started`. The `config` blob is the injected **unresolved** config (not the
+ * resolved `data.config` on the bus): resolving inlines secrets, and the unresolved form is what the
+ * `configHash` is computed over, so blob and hash agree.
+ */
+export declare function buildRuntimeStarted(payload: unknown, unresolvedConfig: Record<string, unknown> | undefined, nowMs: number): RuntimeLifecycleRecord | null;
+/** From `tracking.runtime_stopped`. */
+export declare function buildRuntimeStopped(payload: unknown, nowMs: number): RuntimeLifecycleRecord | null;
+/** From the self-pause HookEvents (`on_strategy_self_paused`/`on_daily_limit_hit`/`on_drawdown_cap_hit`). */
+export declare function buildRuntimePaused(payload: unknown, fallbackGateId: string, nowMs: number): RuntimeStateRecord | null;
+//# sourceMappingURL=record-builders.d.ts.map

package/dist/recording/wiring/record-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-builders.d.ts","sourceRoot":"","sources":["../../../src/recording/wiring/record-builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAElB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EAIrB,aAAa,EAEd,MAAM,eAAe,CAAC;AAoDvB;2FAC2F;AAC3F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA4BxF;AAID,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAwB5F;AAsFD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAqBjI;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAWlH;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,qBAAqB,CAS1F;AAUD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAoCrI;AAID,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CA+C7H;AAID,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA0B5F;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAczJ;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAWlG;AAID,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAcrH"}