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

package/dist/recording/otel/mappers.js

@@ -0,0 +1,337 @@
+/**
+ * The mapper: `RecordingRecord → TraceRow[] | LogRow[]`. Pure functions given their deps (identity,
+ * an injected {@link IdGenerator}, scope) — that is what makes the golden `record → row` tests
+ * deterministic. No `@opentelemetry/*`: this builds wire rows, it is not a span SDK.
+ *
+ * Per-record key maps and the trace-vs-log routing are pinned in {@link ./constants} and appended
+ * to the Task 2 brief. Order within a row: redact (typed-field) → flatten → cap.
+ */
+import { AttrBuilder, durationNs, msToNs } from "./attributes.js";
+import { EXCEPTION_EVENT_NAME, eventNameFor, ROUTING, severityFor, SPAN_NAME, TRACE_FLAGS_SAMPLED, } from "./constants.js";
+import { redactRuntimeError, redactRuntimeState, redactSignalEvaluated, } from "./redaction.js";
+import { createLogger } from "../../utils/logger.js";
+const logger = createLogger("[recording][otel][mapper]");
+/**
+ * Identity → `ResourceAttributes` (server-required `service.name` included) + the derived `address`.
+ * Built once per emitter and shared (frozen) across every row it produces. `address` is derived from
+ * `identity.strategyAddress` directly — not read back from the attribute map — so a future attr-budget
+ * edge can never silently empty the ownership/keying field.
+ */
+export function buildResource(identity) {
+    const resourceAttributes = new AttrBuilder()
+        .put("service.name", identity.service)
+        .put("strategy.address", identity.strategyAddress)
+        .put("recipe", identity.recipe)
+        .put("recipe.version", identity.recipeVersion)
+        .put("runtime", identity.runtime)
+        .put("boot.id", identity.bootId)
+        .put("config.hash", identity.configHash)
+        .build();
+    // Frozen: the single resource object is shared by reference across all of an emitter's rows, so
+    // any accidental mutation would corrupt every row at once.
+    Object.freeze(resourceAttributes);
+    return Object.freeze({
+        resourceAttributes,
+        address: (identity.strategyAddress ?? "").toLowerCase(),
+    });
+}
+function spanKindFor(type) {
+    const route = ROUTING[type];
+    return route.kind === "trace" ? route.spanKind : "Internal";
+}
+function makeTraceRow(deps, f) {
+    return {
+        Timestamp: msToNs(f.timestampMs),
+        TraceId: f.traceId,
+        SpanId: f.spanId,
+        ParentSpanId: f.parentSpanId ?? "",
+        TraceState: "",
+        SpanName: f.spanName,
+        SpanKind: f.spanKind,
+        ServiceName: deps.identity.service,
+        Duration: durationNs(f.startedAt, f.endedAt),
+        StatusCode: f.statusCode,
+        StatusMessage: f.statusMessage ?? "",
+        SpanAttributes: f.attrs,
+        ResourceAttributes: deps.resource.resourceAttributes,
+        Events: f.events ?? [],
+        ScopeName: deps.scopeName,
+        ScopeVersion: deps.scopeVersion,
+        TraceFlags: TRACE_FLAGS_SAMPLED,
+        address: deps.resource.address,
+    };
+}
+/**
+ * Build the single log row for a record: `Timestamp`/severity/event-name are all derived from the
+ * record, so each log mapper only supplies its `Body` and flattened attrs. Each log gets fresh,
+ * self-rooted ids (minimal per-record correlation; cross-record threading is deferred).
+ */
+function logRowFor(deps, record, body, attrs) {
+    const severity = severityFor(record);
+    return {
+        Timestamp: msToNs(record.occurredAt),
+        TraceId: deps.ids.traceId(),
+        SpanId: deps.ids.spanId(),
+        TraceFlags: TRACE_FLAGS_SAMPLED,
+        SeverityText: severity.text,
+        SeverityNumber: severity.number,
+        ServiceName: deps.identity.service,
+        Body: body,
+        ResourceAttributes: deps.resource.resourceAttributes,
+        ScopeName: deps.scopeName,
+        ScopeVersion: deps.scopeVersion,
+        LogAttributes: attrs,
+        EventName: eventNameFor(record),
+        address: deps.resource.address,
+    };
+}
+/** OTEL `exception` span event — the idiomatic home for the error-grouping key on a span. */
+function exceptionEvent(timestampMs, errorName, message) {
+    const attrs = new AttrBuilder()
+        .put("exception.type", errorName)
+        .put("exception.message", message)
+        .build();
+    return { Timestamp: msToNs(timestampMs), Name: EXCEPTION_EVENT_NAME, Attributes: attrs };
+}
+// ── scanner_run → one span ─────────────────────────────────────────────────────
+export function mapScannerRun(record, deps) {
+    // Individual `signals[]` are omitted here — counts + summary capture the run's shape, and
+    // per-signal detail lives on `signal_evaluated` children (avoids re-flattening signal meta).
+    const attrs = new AttrBuilder()
+        .put("scanner.id", record.scannerId)
+        .put("scanner.outcome", record.outcome)
+        .put("scanner.status_detail", record.statusDetail)
+        .put("scanner.scanned_count", record.scannedCount)
+        .put("scanner.actionable_count", record.actionableCount)
+        .put("scanner.signal_count", record.signalCount)
+        .put("scanner.reason", record.reason)
+        .put("scanner.error", record.error)
+        .put("scanner.error_name", record.errorName)
+        .putBag("scanner.summary", record.summary)
+        .build();
+    const isError = record.outcome === "error";
+    return [
+        makeTraceRow(deps, {
+            timestampMs: record.startedAt,
+            traceId: deps.ids.traceId(),
+            spanId: deps.ids.spanId(),
+            spanName: SPAN_NAME.scannerRun,
+            spanKind: spanKindFor("scanner_run"),
+            startedAt: record.startedAt,
+            endedAt: record.endedAt,
+            statusCode: isError ? "Error" : "Ok",
+            statusMessage: isError ? (record.error ?? "") : "",
+            attrs,
+            events: isError ? [exceptionEvent(record.endedAt, record.errorName, record.error)] : [],
+        }),
+    ];
+}
+// ── signal_evaluated → pass-span root + one child span per evaluation ────────────
+export function mapSignalEvaluated(record, deps) {
+    const red = redactSignalEvaluated(record);
+    const traceId = deps.ids.traceId();
+    const rootSpanId = deps.ids.spanId();
+    const rootAttrs = new AttrBuilder()
+        .put("scanner.id", red.scannerId)
+        .put("signal.evaluation_count", red.evaluations.length);
+    const d = red.decision;
+    if (d) {
+        rootAttrs
+            .put("decision.execute", d.execute)
+            .put("decision.action_type", d.actionType)
+            .put("decision.action_name", d.actionName)
+            .put("decision.mode", d.mode)
+            .put("decision.confidence", d.confidence)
+            .put("decision.confidence_threshold", d.confidenceThreshold)
+            .put("decision.reasoning", d.reasoning) // kept (length-capped) — high-value agent rationale
+            .put("decision.model", d.model)
+            .put("decision.tokens_used", d.tokensUsed)
+            .put("decision.duration_ms", d.durationMs);
+        // decision.payload is NOT flattened: raw LLM JSON (free-text + arbitrary keys + nested scanner
+        // meta). Its bounded content is already on the per-signal child spans.
+    }
+    const rows = [
+        makeTraceRow(deps, {
+            timestampMs: red.startedAt,
+            traceId,
+            spanId: rootSpanId,
+            spanName: SPAN_NAME.signalPass,
+            spanKind: spanKindFor("signal_evaluated"),
+            startedAt: red.startedAt,
+            endedAt: red.endedAt,
+            statusCode: "Ok",
+            attrs: rootAttrs.build(),
+        }),
+    ];
+    // One child span per evaluation, sharing the root's TraceId (intra-record parenting). Each child
+    // is mapped defensively: a single bad evaluation must not sink the pass span or its siblings.
+    for (const ev of red.evaluations) {
+        try {
+            rows.push(mapEvaluationChild(ev, deps, traceId, rootSpanId, red.startedAt));
+        }
+        catch (err) {
+            logger.warn("dropping signal evaluation child (mapping error)", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return rows;
+}
+function mapEvaluationChild(ev, deps, traceId, parentSpanId, 
+// No per-evaluation timestamps exist; each child is point-in-time at the pass start, Duration 0.
+passStartedAt) {
+    const { signal, outcome } = ev;
+    const attrs = new AttrBuilder()
+        .put("signal.type", signal.signalType)
+        .put("signal.asset", signal.asset)
+        .put("signal.direction", signal.direction)
+        .put("signal.score", signal.score)
+        .put("signal.timestamp", signal.timestamp)
+        .putFactors("signal.factor", signal.factors)
+        // signal.meta is dropped by redaction upstream.
+        .put("outcome.result", outcome.result)
+        .put("outcome.summary", outcome.summary)
+        .put("outcome.reason_code", outcome.reasonCode)
+        .put("outcome.reason", outcome.reason)
+        .put("outcome.error", outcome.error)
+        .put("outcome.error_name", outcome.errorName)
+        .put("outcome.leverage", outcome.leverage)
+        .put("outcome.margin_amount", outcome.marginAmount)
+        .put("outcome.notional_value", outcome.notionalValue)
+        .put("outcome.order_id", outcome.orderId)
+        .put("outcome.entry_price", outcome.entryPrice)
+        .put("outcome.size", outcome.size)
+        .put("outcome.filled", outcome.filled)
+        .put("outcome.execution_as_maker", outcome.executionAsMaker)
+        .put("outcome.required_margin_amount", outcome.requiredMarginAmount)
+        .put("outcome.available_margin_amount", outcome.availableMarginAmount)
+        .build();
+    const isError = outcome.result === "error";
+    return makeTraceRow(deps, {
+        timestampMs: passStartedAt,
+        traceId,
+        spanId: deps.ids.spanId(),
+        parentSpanId,
+        spanName: SPAN_NAME.signalEvaluation,
+        spanKind: spanKindFor("signal_evaluated"),
+        startedAt: passStartedAt,
+        endedAt: passStartedAt,
+        statusCode: isError ? "Error" : "Ok",
+        statusMessage: isError ? (outcome.error ?? "") : "",
+        attrs,
+        events: isError ? [exceptionEvent(passStartedAt, outcome.errorName, outcome.error)] : [],
+    });
+}
+// ── position_lifecycle → one log ─────────────────────────────────────────────────
+export function mapPositionLifecycle(record, deps) {
+    // No bag/PII to scrub here: `reasoning` is kept (length-capped) as high-value agent rationale.
+    const attrs = new AttrBuilder()
+        .put("position.event", record.event)
+        .put("position.asset", record.asset)
+        .put("position.dex", record.dex)
+        .put("position.direction", record.direction)
+        .put("position.entry_price", record.entryPrice)
+        .put("position.size", record.size)
+        .put("position.leverage", record.leverage)
+        .put("position.leverage_type", record.leverageType)
+        .put("position.margin", record.margin)
+        .put("position.unrealized_pnl", record.unrealizedPnl)
+        .put("position.roe", record.roe)
+        .put("position.liquidation_price", record.liquidationPrice)
+        .put("position.reason", record.reason)
+        .put("position.close_reason", record.closeReason)
+        .put("position.closed_price", record.closedPrice)
+        .put("position.closed_size", record.closedSize)
+        .put("position.execution_as_maker", record.executionAsMaker)
+        .put("position.previous_entry_price", record.previousEntryPrice)
+        .put("position.previous_size", record.previousSize)
+        .put("position.size_delta", record.sizeDelta)
+        .put("position.new_asset", record.newAsset)
+        .put("position.order_id", record.orderId)
+        .put("position.order_type", record.orderType)
+        .put("position.margin_amount", record.marginAmount)
+        .put("position.filled", record.filled)
+        .put("position.reasoning", record.reasoning) // kept (length-capped)
+        .build();
+    const dir = record.direction ? ` ${record.direction}` : "";
+    return [logRowFor(deps, record, `position ${record.event} ${record.asset}${dir}`, attrs)];
+}
+// ── dsl_transition → one log ─────────────────────────────────────────────────────
+export function mapDslTransition(record, deps) {
+    const attrs = new AttrBuilder()
+        .put("dsl.transition", record.transition)
+        .put("dsl.asset", record.asset)
+        .put("dsl.dex", record.dex)
+        .put("dsl.trigger_reason", record.triggerReason)
+        .put("dsl.preset", record.preset)
+        .putJson("dsl.tiers", record.tiers)
+        .put("dsl.direction", record.direction)
+        .put("dsl.entry_price", record.entryPrice)
+        .put("dsl.leverage", record.leverage)
+        .put("dsl.margin", record.margin)
+        .put("dsl.size", record.size)
+        .put("dsl.floor_price", record.floorPrice)
+        .put("dsl.new_floor_price", record.newFloorPrice)
+        .put("dsl.phase", record.phase)
+        .put("dsl.tier_index", record.tierIndex)
+        .put("dsl.lock_hw_pct", record.lockHwPct)
+        .put("dsl.trigger_pct", record.triggerPct)
+        .put("dsl.locked_profit_pct", record.lockedProfitPct)
+        .put("dsl.new_sl_price", record.newSLPrice)
+        .put("dsl.sl_order_id", record.slOrderId)
+        .put("dsl.reason", record.reason)
+        .put("dsl.close_reason", record.closeReason)
+        .put("dsl.created_at", record.createdAt)
+        .put("dsl.current_roe", record.currentROE)
+        .put("dsl.high_water_roe", record.highWaterRoe)
+        .put("dsl.high_water_price", record.highWaterPrice)
+        .put("dsl.peak_roe", record.peakROE)
+        .put("dsl.last_price", record.lastPrice)
+        .put("dsl.attempt", record.attempt)
+        .putJson("dsl.updated", record.updated)
+        .put("dsl.backend_dsl_position_id", record.backendDslPositionId)
+        .build();
+    return [logRowFor(deps, record, `dsl ${record.transition} ${record.asset}`, attrs)];
+}
+// ── runtime_error → one log ───────────────────────────────────────────────────────
+export function mapRuntimeError(record, deps) {
+    const red = redactRuntimeError(record);
+    const attrs = new AttrBuilder()
+        .put("runtime.phase", red.phase)
+        .put("runtime.message", red.message)
+        .put("runtime.error_name", red.errorName)
+        .put("runtime.asset", red.asset)
+        .put("runtime.scanner_id", red.scannerId)
+        .put("runtime.stack", red.stack)
+        .build();
+    return [logRowFor(deps, red, `${red.phase}: ${red.message}`, attrs)];
+}
+// ── runtime_lifecycle → one log ───────────────────────────────────────────────────
+export function mapRuntimeLifecycle(record, deps) {
+    const attrs = new AttrBuilder()
+        .put("runtime.phase", record.phase)
+        .put("runtime.version", record.runtimeVersion)
+        .put("runtime.has_dsl", record.hasDsl)
+        .put("runtime.scanner_count", record.scannerCount)
+        .put("runtime.action_count", record.actionCount)
+        .put("runtime.uptime_ms", record.uptimeMs)
+        // Unresolved config blob: single JSON key, size-capped, never flattened (no secrets to scrub).
+        .putConfig("runtime.config", record.config)
+        .build();
+    return [logRowFor(deps, record, `runtime ${record.phase}`, attrs)];
+}
+// ── runtime_state → one log ───────────────────────────────────────────────────────
+export function mapRuntimeState(record, deps) {
+    const red = redactRuntimeState(record);
+    const attrs = new AttrBuilder()
+        .put("runtime.phase", red.phase)
+        .put("runtime.gate_id", red.gateId)
+        .put("runtime.gate_name", red.gateName)
+        .put("runtime.source", red.source)
+        .put("runtime.reason", red.reason)
+        // runtime.metrics dropped by redaction upstream.
+        .build();
+    // `|| gateId` (not `??`): an empty-string gateName must still fall back to the stable id.
+    return [logRowFor(deps, red, `trading ${red.phase}: ${red.gateName || red.gateId}`, attrs)];
+}
+//# sourceMappingURL=mappers.js.map

package/dist/recording/otel/mappers.js.map

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

package/dist/recording/otel/otel-emitter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `OtelEmitter` — the {@link RecordingEmitter} that turns domain records into HyperDX rows and hands
+ * them to the {@link TelemetryBatcher}. It holds the identity envelope, owns the injected id seam,
+ * and dispatches each record to its mapper.
+ *
+ * Never throws (Rule 3): a mapping error is swallowed and logged so telemetry can never alter,
+ * block, or throw into trading behavior. For the multi-row `signal_evaluated` record, child mapping
+ * is already defensive (one bad child cannot sink the pass span or its siblings — see the mapper).
+ */
+import type { RecordingEmitter } from "../emitter.js";
+import type { IdentityEnvelope } from "../identity.js";
+import type { DslTransitionRecord, PositionLifecycleRecord, RuntimeErrorRecord, RuntimeLifecycleRecord, RuntimeStateRecord, ScannerRunRecord, SignalEvaluatedRecord } from "../records.js";
+import type { TelemetryBatcher } from "../transport/index.js";
+import { type IdGenerator } from "./ids.js";
+export interface OtelEmitterOptions {
+    /** Id generator seam — defaults to {@link cryptoIdGenerator}; tests inject a deterministic stub. */
+    readonly ids?: IdGenerator;
+    readonly scopeName?: string;
+    /** Defaults to {@link SCOPE_VERSION}; Task 4 wiring can pass the real package version. */
+    readonly scopeVersion?: string;
+}
+export declare class OtelEmitter implements RecordingEmitter {
+    private readonly batcher;
+    private readonly deps;
+    constructor(identity: IdentityEnvelope, batcher: TelemetryBatcher, options?: OtelEmitterOptions);
+    recordScannerRun(record: ScannerRunRecord): void;
+    recordSignalEvaluated(record: SignalEvaluatedRecord): void;
+    recordPositionLifecycle(record: PositionLifecycleRecord): void;
+    recordDslTransition(record: DslTransitionRecord): void;
+    recordError(record: RuntimeErrorRecord): void;
+    recordRuntimeLifecycle(record: RuntimeLifecycleRecord): void;
+    recordRuntimeState(record: RuntimeStateRecord): void;
+    private emitTraces;
+    private emitLogs;
+    private swallow;
+}
+//# sourceMappingURL=otel-emitter.d.ts.map

package/dist/recording/otel/otel-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-emitter.d.ts","sourceRoot":"","sources":["../../../src/recording/otel/otel-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAU,gBAAgB,EAAY,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAgB/D,MAAM,WAAW,kBAAkB;IACjC,oGAAoG;IACpG,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,WAAY,YAAW,gBAAgB;IAKhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAGhC,QAAQ,EAAE,gBAAgB,EACT,OAAO,EAAE,gBAAgB,EAC1C,OAAO,GAAE,kBAAuB;IAYlC,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIhD,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAI1D,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAI9D,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAItD,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAI7C,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAI5D,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAIpD,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,OAAO;CAMhB"}

package/dist/recording/otel/otel-emitter.js

@@ -0,0 +1,75 @@
+/**
+ * `OtelEmitter` — the {@link RecordingEmitter} that turns domain records into HyperDX rows and hands
+ * them to the {@link TelemetryBatcher}. It holds the identity envelope, owns the injected id seam,
+ * and dispatches each record to its mapper.
+ *
+ * Never throws (Rule 3): a mapping error is swallowed and logged so telemetry can never alter,
+ * block, or throw into trading behavior. For the multi-row `signal_evaluated` record, child mapping
+ * is already defensive (one bad child cannot sink the pass span or its siblings — see the mapper).
+ */
+import { SCOPE_NAME, SCOPE_VERSION } from "./constants.js";
+import { cryptoIdGenerator } from "./ids.js";
+import { buildResource, mapDslTransition, mapPositionLifecycle, mapRuntimeError, mapRuntimeLifecycle, mapRuntimeState, mapScannerRun, mapSignalEvaluated, } from "./mappers.js";
+import { createLogger } from "../../utils/logger.js";
+const logger = createLogger("[recording][otel][emitter]");
+export class OtelEmitter {
+    batcher;
+    deps;
+    constructor(identity, batcher, options = {}) {
+        this.batcher = batcher;
+        this.deps = {
+            identity,
+            // Identity is immutable for the emitter's lifetime — build the resource (attrs + address) once.
+            resource: buildResource(identity),
+            ids: options.ids ?? cryptoIdGenerator,
+            scopeName: options.scopeName ?? SCOPE_NAME,
+            scopeVersion: options.scopeVersion ?? SCOPE_VERSION,
+        };
+    }
+    recordScannerRun(record) {
+        this.emitTraces("recordScannerRun", () => mapScannerRun(record, this.deps));
+    }
+    recordSignalEvaluated(record) {
+        this.emitTraces("recordSignalEvaluated", () => mapSignalEvaluated(record, this.deps));
+    }
+    recordPositionLifecycle(record) {
+        this.emitLogs("recordPositionLifecycle", () => mapPositionLifecycle(record, this.deps));
+    }
+    recordDslTransition(record) {
+        this.emitLogs("recordDslTransition", () => mapDslTransition(record, this.deps));
+    }
+    recordError(record) {
+        this.emitLogs("recordError", () => mapRuntimeError(record, this.deps));
+    }
+    recordRuntimeLifecycle(record) {
+        this.emitLogs("recordRuntimeLifecycle", () => mapRuntimeLifecycle(record, this.deps));
+    }
+    recordRuntimeState(record) {
+        this.emitLogs("recordRuntimeState", () => mapRuntimeState(record, this.deps));
+    }
+    emitTraces(label, map) {
+        try {
+            for (const row of map())
+                this.batcher.enqueueTrace(row);
+        }
+        catch (err) {
+            this.swallow(label, err);
+        }
+    }
+    emitLogs(label, map) {
+        try {
+            for (const row of map())
+                this.batcher.enqueueLog(row);
+        }
+        catch (err) {
+            this.swallow(label, err);
+        }
+    }
+    swallow(label, err) {
+        logger.warn("recording emit failed; swallowed (telemetry must never throw into trading)", {
+            method: label,
+            err: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=otel-emitter.js.map

package/dist/recording/otel/otel-emitter.js.map

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

package/dist/recording/otel/redaction.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Redaction (Rule 6) — the only place sensitive data is scrubbed. It runs on **typed fields by
+ * name, before flattening**: the sensitive fields are enumerable, so this is deterministic and
+ * testable, more robust than scrubbing flattened keys after the fact.
+ *
+ * Policy (value-vs-risk, confirmed against the real producers):
+ * - **Drop the two genuinely-open bags wholesale.** `SignalSummary.meta` is bounded only for the
+ *   scanners we ship, but the runtime exists to host arbitrary scanner implementations, so its
+ *   contents can't be vouched for. `SignalDecision.payload` is raw LLM JSON validated only as "an
+ *   object" (free-text + arbitrary keys + a nested scanner-meta passthrough). Neither ships; the
+ *   high-value bounded data they'd carry is already on typed scalars / the per-signal child spans.
+ * - **Mask `RuntimeErrorRecord.stack`** (it can embed file paths / secrets) with {@link REDACT_MARKER}.
+ * - **Kept (NOT redacted), only length-capped at flatten time:** `SignalDecision.reasoning` and
+ *   `PositionLifecycleRecord.reasoning` (high-value agent rationale — paired with the child spans
+ *   they let you audit whether the reasoning matched the decision), and `RuntimeStateRecord.reason`
+ *   (code-templated "why trading paused" string with live numbers, no user/LLM input).
+ * - `RuntimeStateRecord.metrics` is dropped — provably numeric/boolean, but not requested for now.
+ * - `RuntimeLifecycleRecord.config` is the *unresolved* config (placeholders intact, no inlined
+ *   secrets), so it is only size-capped, never redacted.
+ *
+ * `decision.payload` is dropped by simply not flattening it in the mapper; this module clears the
+ * fields that must not survive even if a future mapper change tries to read them.
+ */
+import type { RuntimeErrorRecord, RuntimeStateRecord, SignalEvaluatedRecord } from "../records.js";
+/** Drop `signal.meta` (open bag, arbitrary scanner contents). `reasoning` is kept (length-capped). */
+export declare function redactSignalEvaluated(record: SignalEvaluatedRecord): SignalEvaluatedRecord;
+/** Mask `stack` (may embed paths/secrets). The `message` is kept — it is the grouping context. */
+export declare function redactRuntimeError(record: RuntimeErrorRecord): RuntimeErrorRecord;
+/** Drop the `metrics` bag (not surfaced for now). `reason` is kept (code-templated, length-capped). */
+export declare function redactRuntimeState(record: RuntimeStateRecord): RuntimeStateRecord;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/recording/otel/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../../src/recording/otel/redaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAEvB,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CAK1F;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAGjF;AAED,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAEjF"}

package/dist/recording/otel/redaction.js

@@ -0,0 +1,40 @@
+/**
+ * Redaction (Rule 6) — the only place sensitive data is scrubbed. It runs on **typed fields by
+ * name, before flattening**: the sensitive fields are enumerable, so this is deterministic and
+ * testable, more robust than scrubbing flattened keys after the fact.
+ *
+ * Policy (value-vs-risk, confirmed against the real producers):
+ * - **Drop the two genuinely-open bags wholesale.** `SignalSummary.meta` is bounded only for the
+ *   scanners we ship, but the runtime exists to host arbitrary scanner implementations, so its
+ *   contents can't be vouched for. `SignalDecision.payload` is raw LLM JSON validated only as "an
+ *   object" (free-text + arbitrary keys + a nested scanner-meta passthrough). Neither ships; the
+ *   high-value bounded data they'd carry is already on typed scalars / the per-signal child spans.
+ * - **Mask `RuntimeErrorRecord.stack`** (it can embed file paths / secrets) with {@link REDACT_MARKER}.
+ * - **Kept (NOT redacted), only length-capped at flatten time:** `SignalDecision.reasoning` and
+ *   `PositionLifecycleRecord.reasoning` (high-value agent rationale — paired with the child spans
+ *   they let you audit whether the reasoning matched the decision), and `RuntimeStateRecord.reason`
+ *   (code-templated "why trading paused" string with live numbers, no user/LLM input).
+ * - `RuntimeStateRecord.metrics` is dropped — provably numeric/boolean, but not requested for now.
+ * - `RuntimeLifecycleRecord.config` is the *unresolved* config (placeholders intact, no inlined
+ *   secrets), so it is only size-capped, never redacted.
+ *
+ * `decision.payload` is dropped by simply not flattening it in the mapper; this module clears the
+ * fields that must not survive even if a future mapper change tries to read them.
+ */
+import { REDACT_MARKER } from "./constants.js";
+/** Drop `signal.meta` (open bag, arbitrary scanner contents). `reasoning` is kept (length-capped). */
+export function redactSignalEvaluated(record) {
+    const evaluations = record.evaluations.map((ev) => ev.signal.meta === undefined ? ev : { ...ev, signal: { ...ev.signal, meta: undefined } });
+    return { ...record, evaluations };
+}
+/** Mask `stack` (may embed paths/secrets). The `message` is kept — it is the grouping context. */
+export function redactRuntimeError(record) {
+    if (!record.stack)
+        return record;
+    return { ...record, stack: REDACT_MARKER };
+}
+/** Drop the `metrics` bag (not surfaced for now). `reason` is kept (code-templated, length-capped). */
+export function redactRuntimeState(record) {
+    return { ...record, metrics: null };
+}
+//# sourceMappingURL=redaction.js.map

package/dist/recording/otel/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../../src/recording/otel/redaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,WAAW,GAAuB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACpE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CACzF,CAAC;IACF,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAC7C,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC"}