@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/shared/transport/otlp-shared.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Default client name stamped on User-Agent headers and OTel scope/logger
+ * names when the consumer does not provide one. Single source of truth —
+ * import this constant rather than repeating the literal.
+ */
+export declare const DEFAULT_CLIENT_NAME = "ai-telemetry";
+/**
+ * Returns true when `headers` contains at least one recognised auth header
+ * (`api-key`, `authorization`, or `x-license-key`). Shared by OtlpTransport
+ * and OtlpEventBridge so both warn when no auth header is present (§TR4).
+ */
+export declare function hasOtlpAuthHeader(headers: Record<string, string>): boolean;
+export declare function validateOtlpEndpoint(endpoint: string, source: string): void;
+//# sourceMappingURL=otlp-shared.d.ts.map

package/dist/shared/transport/otlp-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-shared.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/otlp-shared.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAM1E;AAOD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAsB3E"}

package/dist/shared/transport/otlp-shared.js

@@ -0,0 +1,49 @@
+import { createLogger } from '../logger.js';
+const logger = createLogger('otlp-shared');
+/**
+ * Default client name stamped on User-Agent headers and OTel scope/logger
+ * names when the consumer does not provide one. Single source of truth —
+ * import this constant rather than repeating the literal.
+ */
+export const DEFAULT_CLIENT_NAME = 'ai-telemetry';
+/**
+ * Returns true when `headers` contains at least one recognised auth header
+ * (`api-key`, `authorization`, or `x-license-key`). Shared by OtlpTransport
+ * and OtlpEventBridge so both warn when no auth header is present (§TR4).
+ */
+export function hasOtlpAuthHeader(headers) {
+    for (const key of Object.keys(headers)) {
+        const lk = key.toLowerCase();
+        if (lk === 'api-key' || lk === 'authorization' || lk === 'x-license-key')
+            return true;
+    }
+    return false;
+}
+// validate OTLP endpoint scheme. https:// is required for
+// any non-localhost destination because the payload may contain user prompt
+// fragments (PII). Plain http:// is allowed only against loopback to support
+// local development and testing. Shared by OtlpTransport and OtlpEventBridge
+// (§OT2 — deduplicates previously identical implementations).
+export function validateOtlpEndpoint(endpoint, source) {
+    let parsed;
+    try {
+        parsed = new URL(endpoint);
+    }
+    catch {
+        throw new Error(`${source}: invalid OTLP endpoint URL: ${endpoint}`);
+    }
+    if (parsed.protocol === 'https:')
+        return;
+    if (parsed.protocol !== 'http:') {
+        throw new Error(`${source}: OTLP endpoint must use http(s); got ${parsed.protocol}`);
+    }
+    // http://: only acceptable on loopback
+    const host = parsed.hostname;
+    // 0.0.0.0 is a wildcard that binds to ALL interfaces, not loopback only —
+    // cleartext traffic to it is reachable from any network (§TR5).
+    const isLoopback = host === 'localhost' || host === '127.0.0.1' || host === '::1';
+    if (!isLoopback) {
+        logger.warn(`${source}: OTLP endpoint uses plain http:// to a non-loopback host — payload may contain PII and should not be transmitted in cleartext`, { endpoint });
+    }
+}
+//# sourceMappingURL=otlp-shared.js.map

package/dist/shared/transport/otlp-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-shared.js","sourceRoot":"","sources":["../../../src/shared/transport/otlp-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAC/D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,eAAe,IAAI,EAAE,KAAK,eAAe;YAAE,OAAO,IAAI,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,MAAc;IACnE,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO;IACzC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,yCAAyC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,uCAAuC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,UAAU,GAAG,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK,CAAC;IAClF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CACT,GAAG,MAAM,gIAAgI,EACzI,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/shared/transport/otlp-transport.d.ts

@@ -0,0 +1,58 @@
+import type { NrMetric } from './types.js';
+export interface OtlpTransportOptions {
+    endpoint: string;
+    headers?: Record<string, string>;
+    appName: string;
+    /** Override the default 30-second request timeout for exportMetrics (§TR7). */
+    requestTimeoutMs?: number;
+    /**
+     * Identifies the consuming client in the `User-Agent` header and as the
+     * OTel instrumentation scope name. Defaults to
+     * `'ai-telemetry'` when not provided. Pass `'preflight'`, `'my-agent'`,
+     * etc. so telemetry from different consumers is distinguishable.
+     */
+    clientName?: string;
+}
+export declare class OtlpTransport {
+    private readonly traceExporter;
+    private readonly metricExporter;
+    private readonly tracerProvider;
+    private readonly meterProvider;
+    private readonly endpoint;
+    private readonly headers;
+    private readonly requestTimeoutMs;
+    private readonly clientName;
+    private hasWarnedNoAuth;
+    /**
+     * Resource attributes shared by both the SDK-driven path (tracer/meter
+     * providers) and the manual `exportMetrics` payload.
+     * Keeping a single resolved attribute map prevents `service.name` from
+     * drifting between the two paths — previously `this.appName` was stored
+     * separately and re-encoded into the OTLP envelope, which would silently
+     * diverge if anyone added a second resource attribute.
+     */
+    private readonly resourceAttributes;
+    constructor(options: OtlpTransportOptions);
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Return an OTel `Tracer` for the given instrumentation name. The returned
+     * value is the `Tracer` interface from `@opentelemetry/api`
+     *; consumers that bind to the type explicitly should
+     * `import type { Tracer } from '@opentelemetry/api'`. `@opentelemetry/api`
+     * is already a regular dependency of this package, so no extra install is
+     * required. The type is intentionally NOT re-exported from this package's
+     * public surface — keeping the public API minimal so consumers that never
+     * use OTel tracing don't see an OTel-shaped type graph leaking through
+     * unrelated imports.
+     */
+    getTracer(name: string): import("@opentelemetry/api").Tracer;
+    /**
+     * Return an OTel `Meter` for the given instrumentation name. See
+     * {@link getTracer} for the dependency story; same rules apply
+     * (`import type { Meter } from '@opentelemetry/api'`).
+     */
+    getMeter(name: string): import("@opentelemetry/api").Meter;
+    exportMetrics(metrics: NrMetric[]): Promise<void>;
+}
+//# sourceMappingURL=otlp-transport.d.ts.map

package/dist/shared/transport/otlp-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-transport.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/otlp-transport.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAiD,MAAM,YAAY,CAAC;AAQ1F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,eAAe,CAAS;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAmC;gBAE1D,OAAO,EAAE,oBAAoB;IAqCnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM;IAItB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM;IAIf,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAwJxD"}

package/dist/shared/transport/otlp-transport.js

@@ -0,0 +1,236 @@
+import { gzip } from 'node:zlib';
+import { promisify } from 'node:util';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
+import { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-node';
+import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { createLogger } from '../logger.js';
+import { validateOtlpEndpoint, hasOtlpAuthHeader, DEFAULT_CLIENT_NAME } from './otlp-shared.js';
+import { VERSION } from '../version.js';
+const gzipAsync = promisify(gzip);
+const logger = createLogger('otlp-transport');
+export class OtlpTransport {
+    traceExporter;
+    metricExporter;
+    tracerProvider;
+    meterProvider;
+    endpoint;
+    headers;
+    requestTimeoutMs;
+    clientName;
+    hasWarnedNoAuth = false;
+    /**
+     * Resource attributes shared by both the SDK-driven path (tracer/meter
+     * providers) and the manual `exportMetrics` payload.
+     * Keeping a single resolved attribute map prevents `service.name` from
+     * drifting between the two paths — previously `this.appName` was stored
+     * separately and re-encoded into the OTLP envelope, which would silently
+     * diverge if anyone added a second resource attribute.
+     */
+    resourceAttributes;
+    constructor(options) {
+        validateOtlpEndpoint(options.endpoint, 'OtlpTransport');
+        this.clientName = options.clientName || DEFAULT_CLIENT_NAME;
+        this.resourceAttributes = Object.freeze({ 'service.name': options.appName });
+        const resource = resourceFromAttributes({ ...this.resourceAttributes });
+        this.endpoint = options.endpoint;
+        this.headers = options.headers ?? {};
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+        this.traceExporter = new OTLPTraceExporter({
+            url: `${options.endpoint}/v1/traces`,
+            headers: options.headers ?? {},
+        });
+        this.metricExporter = new OTLPMetricExporter({
+            url: `${options.endpoint}/v1/metrics`,
+            headers: options.headers ?? {},
+        });
+        this.tracerProvider = new BasicTracerProvider({
+            resource,
+            spanProcessors: [new BatchSpanProcessor(this.traceExporter)],
+        });
+        this.meterProvider = new MeterProvider({
+            resource,
+            readers: [
+                new PeriodicExportingMetricReader({
+                    exporter: this.metricExporter,
+                    exportIntervalMillis: 60_000,
+                }),
+            ],
+        });
+    }
+    async flush() {
+        await this.tracerProvider.forceFlush();
+        await this.meterProvider.forceFlush();
+    }
+    async shutdown() {
+        await this.tracerProvider.shutdown();
+        await this.meterProvider.shutdown();
+    }
+    /**
+     * Return an OTel `Tracer` for the given instrumentation name. The returned
+     * value is the `Tracer` interface from `@opentelemetry/api`
+     *; consumers that bind to the type explicitly should
+     * `import type { Tracer } from '@opentelemetry/api'`. `@opentelemetry/api`
+     * is already a regular dependency of this package, so no extra install is
+     * required. The type is intentionally NOT re-exported from this package's
+     * public surface — keeping the public API minimal so consumers that never
+     * use OTel tracing don't see an OTel-shaped type graph leaking through
+     * unrelated imports.
+     */
+    getTracer(name) {
+        return this.tracerProvider.getTracer(name);
+    }
+    /**
+     * Return an OTel `Meter` for the given instrumentation name. See
+     * {@link getTracer} for the dependency story; same rules apply
+     * (`import type { Meter } from '@opentelemetry/api'`).
+     */
+    getMeter(name) {
+        return this.meterProvider.getMeter(name);
+    }
+    async exportMetrics(metrics) {
+        if (metrics.length === 0)
+            return;
+        // Warn ONCE when no auth header is present — emitting on every call would
+        // flood stderr with identical lines in long-running agents (§TR1).
+        if (!hasOtlpAuthHeader(this.headers) && !this.hasWarnedNoAuth) {
+            this.hasWarnedNoAuth = true;
+            logger.warn('OTLP metric export attempted with no auth header — collector may reject', {
+                endpoint: this.endpoint,
+            });
+        }
+        const otlpAttributes = (attrs) => Object.entries(attrs ?? {}).map(([key, value]) => ({
+            key,
+            value: typeof value === 'number'
+                ? { doubleValue: value }
+                : typeof value === 'boolean'
+                    ? { boolValue: value }
+                    : { stringValue: String(value) },
+        }));
+        const numericDataPoint = (m) => ({
+            // For count (delta Sum) metrics, include startTimeUnixNano per the OTLP
+            // spec (§TR2). Gauge data points do not require it but it is harmless.
+            // Clamp to 0: if timestamp < intervalMs (misconfigured metric), a negative
+            // startTimeUnixNano would be rejected by strict OTLP collectors (§TR7).
+            startTimeUnixNano: m.type === 'count' ? Math.max(0, m.timestamp - m.intervalMs) * 1_000_000 : undefined,
+            timeUnixNano: m.timestamp * 1_000_000,
+            asDouble: m.value,
+            attributes: otlpAttributes(m.attributes),
+        });
+        // summary is now a first-class type with a structured
+        // value `{ count, sum, min, max }`. OTLP doesn't have a single
+        // "Summary"-shaped metric kind; the closest faithful mapping is OTLP
+        // Histogram with explicit `count` and `sum` fields plus per-data-point
+        // `min` / `max`. Bucket boundaries are intentionally omitted: NR doesn't
+        // need them for summary aggregation, and emitting empty `bucketCounts`
+        // alongside `min`/`max` is the documented OTLP shape for unbucketed
+        // summaries (`explicitBounds: []`, `bucketCounts: [<count>]`).
+        const summaryDataPoint = (m) => ({
+            // OTLP Histogram with DELTA temporality requires startTimeUnixNano (§TR2).
+            startTimeUnixNano: Math.max(0, m.timestamp - m.intervalMs) * 1_000_000,
+            timeUnixNano: m.timestamp * 1_000_000,
+            attributes: otlpAttributes(m.attributes),
+            count: m.value.count,
+            sum: m.value.sum,
+            min: m.value.min,
+            max: m.value.max,
+            bucketCounts: [m.value.count],
+            explicitBounds: [],
+        });
+        // Map NrMetric.type → OTLP metric kind:
+        //   - `gauge`   → OTLP Gauge (point-in-time numeric value)
+        //   - `count`   → OTLP Sum (monotonic, DELTA aggregation temporality = 1).
+        //     NrCountMetric carries intervalMs — it represents a bounded-interval
+        //     delta, not a cumulative running total. Using CUMULATIVE (2) would
+        //     cause downstream collectors to treat each harvest as a monotonically-
+        //     increasing total, producing incorrect rate calculations (§TR1).
+        //   - `summary` → OTLP Histogram (with explicit min/max/sum/count fields,
+        //     no buckets) — see §4.9 note above on why histogram is the closest
+        //     faithful mapping.
+        const otlpMetric = (m) => {
+            if (m.type === 'count') {
+                return {
+                    name: m.name,
+                    sum: {
+                        dataPoints: [numericDataPoint(m)],
+                        // 1 = DELTA — the value represents the count within intervalMs,
+                        // not a cumulative total from a fixed epoch.
+                        aggregationTemporality: 1,
+                        isMonotonic: true,
+                    },
+                };
+            }
+            if (m.type === 'summary') {
+                return {
+                    name: m.name,
+                    histogram: {
+                        dataPoints: [summaryDataPoint(m)],
+                        // Aggregation temporality 1 = DELTA (the count/sum/min/max
+                        // describe the harvest interval, not a cumulative total).
+                        aggregationTemporality: 1,
+                    },
+                };
+            }
+            return { name: m.name, gauge: { dataPoints: [numericDataPoint(m)] } };
+        };
+        const payload = {
+            resourceMetrics: [
+                {
+                    resource: {
+                        attributes: Object.entries(this.resourceAttributes).map(([key, value]) => ({
+                            key,
+                            value: { stringValue: value },
+                        })),
+                    },
+                    scopeMetrics: [
+                        {
+                            scope: { name: this.clientName },
+                            metrics: metrics.map(otlpMetric),
+                        },
+                    ],
+                },
+            ],
+        };
+        // exportMetrics MUST surface failures so
+        // HarvestScheduler.sendMetricsToOtlp can catch and requeue into
+        // retryOtlpMetricBatch. Previously this method swallowed errors with
+        // a logger.warn and resolved successfully, which silently dropped
+        // every OTLP metric failure and made the scheduler's per-OTLP retry
+        // buffer dead code. Note this is asymmetric with OTLP *events*: the
+        // event path goes through OtlpEventBridge → BatchLogRecordProcessor,
+        // which retries internally inside the OTel SDK, so the scheduler-
+        // level retry queue is rarely engaged for events. For metrics, we
+        // intentionally rely on the scheduler's retry queue instead — there
+        // is no PeriodicExportingMetricReader in this code path.
+        // Gzip-compress the payload to match sendWithRetry (§TR3). The NR OTLP
+        // endpoint accepts gzip; for large metric batches this is a 5-10× size win.
+        const compressed = await gzipAsync(JSON.stringify(payload));
+        const response = await fetch(`${this.endpoint}/v1/metrics`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Encoding': 'gzip',
+                'User-Agent': `${this.clientName}/${VERSION}`,
+                ...this.headers,
+            },
+            body: compressed,
+            signal: AbortSignal.timeout(this.requestTimeoutMs),
+            // §5.20 — see http-client.ts for rationale.
+            keepalive: true,
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            const msg = `OTLP metric export failed: HTTP ${response.status}${body ? ` — ${body.slice(0, 256)}` : ''}`;
+            // 400 means the payload itself is malformed — retrying the same payload
+            // will always fail, so surface this as a distinct non-retryable error (§TR9).
+            if (response.status === 400) {
+                throw Object.assign(new Error(msg), { code: 'OTLP_BAD_REQUEST' });
+            }
+            throw new Error(msg);
+        }
+        // Drain on success so undici returns the socket to the keep-alive pool (§HC1).
+        await response.body?.cancel().catch(() => { });
+    }
+}
+//# sourceMappingURL=otlp-transport.js.map

package/dist/shared/transport/otlp-transport.js.map

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

package/dist/shared/transport/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Selects which downstream transport(s) the harvest scheduler ships to
+ *. Single source of truth for the literal union — both
+ * `AgentConfig.transport` and `HarvestSchedulerOptions.transport` consume
+ * this type so a future addition (e.g. a Datadog transport) only needs to
+ * widen the union here.
+ *
+ * **This is a TypeScript-only type alias, not a runtime value.** Consumers
+ * import it with `import type { TransportMode } from '@newrelic/ai-telemetry'`
+ * and pass the bare string literals at runtime — `transport: 'otlp'` rather
+ * than `transport: TransportMode.OTLP`. There is no enum-like object to
+ * dot-access; a runtime membership check should compare against the
+ * literal strings directly (see `envTransport()` in `src/config.ts` for
+ * the canonical narrowing pattern).
+ *
+ * - `'nr-events-api'` — stream NR events through the dedicated Events API
+ *   and metrics through the Metric API. Default. Lowest-latency path for
+ *   `AiRequest` / `AiResponse` style events.
+ * - `'otlp'`           — stream the same data over OTLP/HTTP, both spans
+ *   (events bridged via `OtlpEventBridge`) and metrics. Pick this when the
+ *   collector is an OTel-native one or when the consumer wants spans
+ *   instead of NR custom events.
+ * - `'both'`           — fan out to NR Events API AND OTLP. Each transport
+ *   keeps its own retry buffer; a NR-side failure does not double-send to
+ *   OTLP.
+ */
+export type TransportMode = 'nr-events-api' | 'otlp' | 'both';
+/**
+ * Wire-format value for an `NrMetric` of type `'summary'`.
+ * Mirrors the NR Metric API summary shape exactly.
+ */
+export interface NrMetricSummaryValue {
+    readonly count: number;
+    readonly sum: number;
+    readonly min: number;
+    readonly max: number;
+}
+/**
+ * Common fields on every NR metric type.
+ *
+ * NB: when serialized to the wire, `intervalMs` becomes the JSON key
+ * `'interval.ms'` per NR's Metric API contract — see `sendMetrics` in
+ * `metric-api.ts` for the per-metric rename. The TypeScript identifier
+ * is camelCased to keep call sites idiomatic.
+ */
+export interface NrMetricBase {
+    readonly name: string;
+    readonly timestamp: number;
+    readonly attributes?: Record<string, string | number | boolean>;
+    /**
+     * Interval (ms) over which the count or summary was sampled. Required for
+     * `count` and `summary` metric types per NR's Metric API; ignored for
+     * `gauge` (point-in-time) metrics. Renamed to `interval.ms` on the wire.
+     */
+    readonly intervalMs?: number;
+}
+/** Point-in-time gauge metric. */
+export interface NrGaugeMetric extends NrMetricBase {
+    readonly type: 'gauge';
+    readonly value: number;
+}
+/**
+ * Delta-count metric over the interval window. NR treats `count` as the
+ * number of events observed during `intervalMs`.
+ */
+export interface NrCountMetric extends NrMetricBase {
+    readonly type: 'count';
+    readonly value: number;
+    readonly intervalMs: number;
+}
+/**
+ * Pre-aggregated summary metric — `count`, `sum`, `min`, `max` over the
+ * interval window. One summary metric replaces what would otherwise be four
+ * separate `.count` / `.sum` / `.min` / `.max` data points,
+ * halving payload cardinality and matching NR's NRQL ergonomics.
+ */
+export interface NrSummaryMetric extends NrMetricBase {
+    readonly type: 'summary';
+    readonly value: NrMetricSummaryValue;
+    readonly intervalMs: number;
+}
+export type NrMetric = NrGaugeMetric | NrCountMetric | NrSummaryMetric;
+export interface TransportOptions {
+    /** NR account ID — required for Events API URL path. */
+    readonly accountId: string;
+    /** Override collector host; used for EU region routing or custom endpoints. */
+    readonly collectorHost?: string | null;
+    /** Max retry attempts for retryable errors. Default: 3. */
+    readonly maxRetries?: number;
+    /** Base delay in ms for exponential backoff. Default: 1000. */
+    readonly baseDelayMs?: number;
+    /** Maximum delay in ms for backoff cap. Default: 30000. */
+    readonly maxDelayMs?: number;
+    /**
+     * Per-request timeout in ms — aborts the in-flight fetch and lets the
+     * retry/backoff machinery handle it. Default: 30000.
+     *
+     * Without this, a hung TCP connection stalls the entire harvest loop
+     * indefinitely with no recovery.
+     */
+    readonly requestTimeoutMs?: number;
+    /**
+     * Identifies the consuming client in the `User-Agent` header sent to NR
+     * ingest endpoints (e.g. `'preflight'`, `'my-agent'`). Defaults to
+     * `'ai-telemetry'` when not provided.
+     */
+    readonly clientName?: string;
+}
+export interface TransportResult {
+    readonly success: boolean;
+    readonly statusCode: number | null;
+    readonly retryCount: number;
+    readonly error?: string;
+}
+export interface HttpSendOptions {
+    readonly url: string;
+    readonly body: unknown;
+    readonly licenseKey: string;
+    readonly maxRetries: number;
+    readonly baseDelayMs: number;
+    readonly maxDelayMs: number;
+    readonly requestTimeoutMs: number;
+    /**
+     * Identifies the consuming client in the `User-Agent` header. Defaults to
+     * `'ai-telemetry'` when not provided.
+     */
+    readonly clientName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAChE;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/shared/transport/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/transport/types.ts"],"names":[],"mappings":""}

package/dist/shared/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/shared/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/shared/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/shared/version.js

@@ -0,0 +1,2 @@
+export const VERSION = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/shared/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/shared/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,7 @@
+export { LocalStore } from './local-store.js';
+export type { HookEvent, SessionSummary, AuditEntry, ReplayTimelineEntry } from './types.js';
+export { SessionStore, buildSessionSummary } from './session-store.js';
+export type { FullSessionSummary, SessionFileInfo } from './session-store.js';
+export { WeeklySummaryGenerator, getIsoWeekId } from './weekly-summary.js';
+export type { WeeklySummary, DeveloperWeeklyStats } from './weekly-summary.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,4 @@
+export { LocalStore } from './local-store.js';
+export { SessionStore, buildSessionSummary } from './session-store.js';
+export { WeeklySummaryGenerator, getIsoWeekId } from './weekly-summary.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}