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

package/dist/recording/transport/batcher.js.map

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

package/dist/recording/transport/client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HTTP client — POSTs a batch of already-serialized telemetry rows to the
+ * ingestion service with bearer auth, and parses the
+ * `{ accepted, rejected, errors }` response into a {@link SendResult}.
+ *
+ * It transforms NOTHING (the mapper builds the rows) and NEVER throws: network
+ * errors, timeouts, and unreadable bodies resolve to a `SendResult` so the
+ * batcher can account for the drop without the failure reaching the caller.
+ *
+ * Rows arrive pre-serialized (`string[]`): the batcher serializes each row
+ * exactly once (for byte accounting) and reuses that JSON here, so the body is
+ * assembled by concatenation — never serialized a second time.
+ */
+import type { TransportConfig } from "./config.js";
+/**
+ * How a POST resolved. Drives the batcher's counters:
+ * - `accepted` — 2xx; the server adjudicated the rows. `accepted`/`rejected`/
+ *   `errors` carry its verdict (partial acceptance is still a 2xx).
+ * - `rejected` — `400`; the server adjudicated the WHOLE batch as invalid
+ *   (every row bad) — a likely mapper bug.
+ * - `oversized` — `413`; the body exceeded the server's size limit. A permanent
+ *   client-side batching defect — not transient transport, not a per-row bug.
+ * - `transport` — network failure, timeout, `401`, `408`, `429`, `5xx`: the
+ *   batch never reached row adjudication. A transport-health signal.
+ */
+export type SendOutcome = "accepted" | "rejected" | "oversized" | "transport";
+export interface SendResult {
+    outcome: SendOutcome;
+    /** HTTP status, or 0 when the request never completed (network/timeout). */
+    status: number;
+    accepted: number;
+    rejected: number;
+    errors: string[];
+}
+export interface TelemetryClient {
+    /** `rowsJson` are pre-serialized rows; the client only frames + POSTs them. */
+    sendTraces(rowsJson: readonly string[]): Promise<SendResult>;
+    sendLogs(rowsJson: readonly string[]): Promise<SendResult>;
+}
+export declare function createTelemetryClient(config: TransportConfig): TelemetryClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/recording/transport/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/recording/transport/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5D;AAwBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA4C9E"}

package/dist/recording/transport/client.js

@@ -0,0 +1,69 @@
+/**
+ * HTTP client — POSTs a batch of already-serialized telemetry rows to the
+ * ingestion service with bearer auth, and parses the
+ * `{ accepted, rejected, errors }` response into a {@link SendResult}.
+ *
+ * It transforms NOTHING (the mapper builds the rows) and NEVER throws: network
+ * errors, timeouts, and unreadable bodies resolve to a `SendResult` so the
+ * batcher can account for the drop without the failure reaching the caller.
+ *
+ * Rows arrive pre-serialized (`string[]`): the batcher serializes each row
+ * exactly once (for byte accounting) and reuses that JSON here, so the body is
+ * assembled by concatenation — never serialized a second time.
+ */
+import { LOGS_PATH, TRACES_PATH } from "./config.js";
+function toCount(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+function toErrors(v) {
+    return Array.isArray(v) ? v.filter((e) => typeof e === "string") : [];
+}
+/** Map an HTTP status to the outcome the batcher accounts on. */
+function classify(status) {
+    if (status >= 200 && status < 300)
+        return "accepted";
+    if (status === 400)
+        return "rejected"; // whole batch invalid — mapper bug
+    if (status === 413)
+        return "oversized"; // body too large — client batching defect
+    return "transport"; // 401 / 408 / 429 / 5xx / other — rows never adjudicated
+}
+export function createTelemetryClient(config) {
+    const base = config.baseUrl.replace(/\/+$/, "");
+    async function send(path, bodyKey, rowsJson) {
+        const headers = { "Content-Type": "application/json" };
+        const token = config.getToken();
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        let response;
+        try {
+            response = await fetch(`${base}${path}`, {
+                method: "POST",
+                headers,
+                // Frame the pre-serialized rows directly — no re-serialization. bodyKey
+                // is a fixed literal ("spans"/"logs"), so no escaping is needed.
+                body: `{"${bodyKey}":[${rowsJson.join(",")}]}`,
+                signal: AbortSignal.timeout(config.requestTimeoutMs),
+            });
+        }
+        catch {
+            // Network error / timeout / abort — never reached the server.
+            return { outcome: "transport", status: 0, accepted: 0, rejected: 0, errors: [] };
+        }
+        const parsed = (await response
+            .json()
+            .catch(() => ({})));
+        return {
+            outcome: classify(response.status),
+            status: response.status,
+            accepted: toCount(parsed.accepted),
+            rejected: toCount(parsed.rejected),
+            errors: toErrors(parsed.errors),
+        };
+    }
+    return {
+        sendTraces: (rowsJson) => send(TRACES_PATH, "spans", rowsJson),
+        sendLogs: (rowsJson) => send(LOGS_PATH, "logs", rowsJson),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/recording/transport/client.js.map

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

package/dist/recording/transport/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Transport config — injected, not hard-coupled to `src/tracking/` or the CLI.
+ *
+ * The caller supplies `getToken` / `baseUrl` (e.g. from the Senpi API-key store
+ * + `SENPI_TRACKING_URL`). Keeping the token an injected getter — rather than a
+ * captured string — lets the credential rotate without rebuilding the batcher,
+ * and keeps this module self-contained, with no dependency on `tracking/`.
+ */
+/** Default ingestion base URL (overridable via `SENPI_TRACKING_URL`). */
+export declare const DEFAULT_BASE_URL = "https://agent-telemetry.prod.senpi.ai";
+/** Endpoint paths, confirmed against the service route registration. */
+export declare const TRACES_PATH = "/v1/traces";
+export declare const LOGS_PATH = "/v1/logs";
+/** Flush cadence — the primary trigger. */
+export declare const DEFAULT_FLUSH_INTERVAL_MS = 5000;
+/**
+ * Client-side per-batch byte cap. The server rejects bodies > 10 MiB; we cap
+ * under that (the service's own route comment notes the runtime emitter uses an
+ * 8 MiB cap with HTTP headroom). Crossing this watermark forces an early flush.
+ */
+export declare const DEFAULT_MAX_BATCH_BYTES: number;
+/** Per-request timeout. Bounds flushes (incl. the best-effort shutdown flush). */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 15000;
+export interface TransportConfig {
+    /** Resolved ingestion base URL (no trailing slash required). */
+    baseUrl: string;
+    /** Returns the current bearer token, or undefined when unavailable. */
+    getToken: () => string | undefined;
+    /** Timer flush cadence in ms. */
+    flushIntervalMs: number;
+    /** Per-batch byte cap that triggers an early flush. */
+    maxBatchBytes: number;
+    /** Per-request timeout in ms. */
+    requestTimeoutMs: number;
+}
+export interface TransportConfigOptions {
+    /** Required: the only thing the caller must supply. */
+    getToken: () => string | undefined;
+    /** Defaults to `SENPI_TRACKING_URL` if set, else {@link DEFAULT_BASE_URL}. */
+    baseUrl?: string;
+    flushIntervalMs?: number;
+    maxBatchBytes?: number;
+    requestTimeoutMs?: number;
+}
+/**
+ * Fill a partial config with defaults, resolving the base URL from env.
+ *
+ * The `SENPI_TRACKING_URL` lookup is intentionally inlined rather than shared
+ * with `src/tracking/`: this module stays self-contained and does not import
+ * from `tracking/`, so the three-line resolver lives here by design.
+ */
+export declare function resolveTransportConfig(options: TransportConfigOptions): TransportConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/recording/transport/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/recording/transport/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,0CAA0C,CAAC;AAExE,wEAAwE;AACxE,eAAO,MAAM,WAAW,eAAe,CAAC;AACxC,eAAO,MAAM,SAAS,aAAa,CAAC;AAEpC,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AAEvD,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnC,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CASjB"}

package/dist/recording/transport/config.js

@@ -0,0 +1,41 @@
+/**
+ * Transport config — injected, not hard-coupled to `src/tracking/` or the CLI.
+ *
+ * The caller supplies `getToken` / `baseUrl` (e.g. from the Senpi API-key store
+ * + `SENPI_TRACKING_URL`). Keeping the token an injected getter — rather than a
+ * captured string — lets the credential rotate without rebuilding the batcher,
+ * and keeps this module self-contained, with no dependency on `tracking/`.
+ */
+/** Default ingestion base URL (overridable via `SENPI_TRACKING_URL`). */
+export const DEFAULT_BASE_URL = "https://agent-telemetry.prod.senpi.ai";
+/** Endpoint paths, confirmed against the service route registration. */
+export const TRACES_PATH = "/v1/traces";
+export const LOGS_PATH = "/v1/logs";
+/** Flush cadence — the primary trigger. */
+export const DEFAULT_FLUSH_INTERVAL_MS = 5_000;
+/**
+ * Client-side per-batch byte cap. The server rejects bodies > 10 MiB; we cap
+ * under that (the service's own route comment notes the runtime emitter uses an
+ * 8 MiB cap with HTTP headroom). Crossing this watermark forces an early flush.
+ */
+export const DEFAULT_MAX_BATCH_BYTES = 8 * 1024 * 1024;
+/** Per-request timeout. Bounds flushes (incl. the best-effort shutdown flush). */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
+/**
+ * Fill a partial config with defaults, resolving the base URL from env.
+ *
+ * The `SENPI_TRACKING_URL` lookup is intentionally inlined rather than shared
+ * with `src/tracking/`: this module stays self-contained and does not import
+ * from `tracking/`, so the three-line resolver lives here by design.
+ */
+export function resolveTransportConfig(options) {
+    const envBase = process.env.SENPI_TRACKING_URL?.trim();
+    return {
+        getToken: options.getToken,
+        baseUrl: options.baseUrl ?? (envBase || DEFAULT_BASE_URL),
+        flushIntervalMs: options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,
+        maxBatchBytes: options.maxBatchBytes ?? DEFAULT_MAX_BATCH_BYTES,
+        requestTimeoutMs: options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/recording/transport/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/recording/transport/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AAExE,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AAEpC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvD,kFAAkF;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAyBjD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA+B;IAE/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACzD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,yBAAyB;QACrE,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,uBAAuB;QAC/D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,0BAA0B;KACzE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Transport / micro-batcher — batches already-row-shaped telemetry and ships it
+ * to the sibling ingestion service, fire-and-forget. Transforms nothing (the
+ * mapper builds the rows); never throws into trading behavior.
+ *
+ * The row types (`TraceRow` / `LogRow`) mirror the service contract and are the
+ * boundary with the mapper that produces them.
+ */
+export type { TraceRow, LogRow, SpanEventRow, SpanKind, StatusCode, TracesEnvelope, LogsEnvelope, IngestResponse, } from "./rows.js";
+export { DEFAULT_BASE_URL, DEFAULT_FLUSH_INTERVAL_MS, DEFAULT_MAX_BATCH_BYTES, DEFAULT_REQUEST_TIMEOUT_MS, TRACES_PATH, LOGS_PATH, resolveTransportConfig, } from "./config.js";
+export type { TransportConfig, TransportConfigOptions } from "./config.js";
+export { createTelemetryClient } from "./client.js";
+export type { TelemetryClient, SendResult, SendOutcome } from "./client.js";
+export { createBatcher } from "./batcher.js";
+export type { TelemetryBatcher, BatcherStats, SignalStats } from "./batcher.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recording/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,WAAW,EACX,SAAS,EACT,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/recording/transport/index.js

@@ -0,0 +1,12 @@
+/**
+ * Transport / micro-batcher — batches already-row-shaped telemetry and ships it
+ * to the sibling ingestion service, fire-and-forget. Transforms nothing (the
+ * mapper builds the rows); never throws into trading behavior.
+ *
+ * The row types (`TraceRow` / `LogRow`) mirror the service contract and are the
+ * boundary with the mapper that produces them.
+ */
+export { DEFAULT_BASE_URL, DEFAULT_FLUSH_INTERVAL_MS, DEFAULT_MAX_BATCH_BYTES, DEFAULT_REQUEST_TIMEOUT_MS, TRACES_PATH, LOGS_PATH, resolveTransportConfig, } from "./config.js";
+export { createTelemetryClient } from "./client.js";
+export { createBatcher } from "./batcher.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recording/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,WAAW,EACX,SAAS,EACT,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/recording/transport/rows.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Telemetry wire types — the mapper produces these; the transport ships them
+ * unchanged.
+ *
+ * Mirrors the sibling ingestion service's row types verbatim: the destination
+ * ClickHouse row shapes — PascalCase keys, flat `Record<string,string>`
+ * attribute maps, epoch-ns timestamps as digit-strings, lowercase-hex ids,
+ * precomputed `Duration`. No OTLP envelope, no `AnyValue`.
+ *
+ * This module performs NO validation — the server's validator is the single
+ * source of truth for the hex/timestamp/enum rules; re-implementing them here
+ * would couple us to the service and drift.
+ */
+export type SpanKind = "Internal" | "Server" | "Client" | "Producer" | "Consumer" | "Unspecified";
+export type StatusCode = "Unset" | "Ok" | "Error";
+export interface SpanEventRow {
+    /** epoch ns as digit string. */
+    Timestamp: string;
+    Name: string;
+    Attributes: Record<string, string>;
+}
+/**
+ * A span row on the wire / destined for Kafka. `address` is a derived field
+ * used for ownership + per-agent keying — not a ClickHouse column.
+ */
+export interface TraceRow {
+    /** epoch ns as string (span start). */
+    Timestamp: string;
+    /** 32-hex lowercase. */
+    TraceId: string;
+    /** 16-hex lowercase. */
+    SpanId: string;
+    /** 16-hex or empty string for roots. */
+    ParentSpanId: string;
+    TraceState: string;
+    SpanName: string;
+    SpanKind: SpanKind;
+    ServiceName: string;
+    /** end − start, ns, as string. */
+    Duration: string;
+    StatusCode: StatusCode;
+    StatusMessage: string;
+    SpanAttributes: Record<string, string>;
+    ResourceAttributes: Record<string, string>;
+    Events: SpanEventRow[];
+    ScopeName: string;
+    ScopeVersion: string;
+    TraceFlags: number;
+    /** Derived: lower(ResourceAttributes['strategy.address']); '' when absent. */
+    address: string;
+}
+/** A log row on the wire / destined for Kafka. `address` is a derived field. */
+export interface LogRow {
+    /** epoch ns as digit string. */
+    Timestamp: string;
+    TraceId: string;
+    SpanId: string;
+    TraceFlags: number;
+    SeverityText: string;
+    SeverityNumber: number;
+    ServiceName: string;
+    Body: string;
+    ResourceAttributes: Record<string, string>;
+    ScopeName: string;
+    ScopeVersion: string;
+    LogAttributes: Record<string, string>;
+    /** Maps to the EventName CH column — the log-type discriminator. */
+    EventName: string;
+    /** Derived: lower(ResourceAttributes['strategy.address']); '' when absent. */
+    address: string;
+}
+export interface TracesEnvelope {
+    spans: TraceRow[];
+}
+export interface LogsEnvelope {
+    logs: LogRow[];
+}
+/**
+ * Server response. Partial acceptance is a `200`; a shortfall in `accepted`
+ * means rows the server refused (e.g. a malformed row that got through the
+ * mapper). A `400` means the whole batch failed validation.
+ */
+export interface IngestResponse {
+    accepted: number;
+    rejected: number;
+    errors?: string[];
+}
+//# sourceMappingURL=rows.d.ts.map

package/dist/recording/transport/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../src/recording/transport/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,UAAU,GACV,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACrB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/recording/transport/rows.js

@@ -0,0 +1,15 @@
+/**
+ * Telemetry wire types — the mapper produces these; the transport ships them
+ * unchanged.
+ *
+ * Mirrors the sibling ingestion service's row types verbatim: the destination
+ * ClickHouse row shapes — PascalCase keys, flat `Record<string,string>`
+ * attribute maps, epoch-ns timestamps as digit-strings, lowercase-hex ids,
+ * precomputed `Duration`. No OTLP envelope, no `AnyValue`.
+ *
+ * This module performs NO validation — the server's validator is the single
+ * source of truth for the hex/timestamp/enum rules; re-implementing them here
+ * would couple us to the service and drift.
+ */
+export {};
+//# sourceMappingURL=rows.js.map

package/dist/recording/transport/rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../../src/recording/transport/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

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"}