agent-nuvira 3.3.1 → 3.3.4

package/dist/observability/otel.js

@@ -0,0 +1,590 @@
+/**
+ * WS3 (#25) — the turn's span tree, exported over OTLP when an operator asks.
+ *
+ * WHY THIS EXISTS. WS2 gave a run a log you can attach to a bug report; that is
+ * one run on one machine. What it cannot do is show a turn's SHAPE across many
+ * runs — which step is slow, which tool is the one that fails, whether the
+ * subagent a turn spawned is where the time went. That is a tracing problem, and
+ * the answer everyone's tooling already speaks is OTLP.
+ *
+ * WHY THE OFFICIAL SDK, here of all places. This repository hand-rolls its
+ * observability on purpose (the debug log, the gateway log, `generateZip`) — and
+ * a native OTLP writer was the obvious first instinct. It was rejected for a
+ * specific reason: the parts hardest to get right are the ones nobody notices
+ * until a collector shows nothing. 64-bit nanosecond timestamps as strings, the
+ * sampled bit in `traceFlags`, an empty-versus-omitted `parentSpanId`, header
+ * parsing, retries, gzip — each is a silent failure mode, and none of them is
+ * this project's problem to own. `@opentelemetry/*` already ships them correct,
+ * and anything that speaks OTLP accepts what it produces.
+ *
+ * THREE RULES, each closing a way tracing makes a product worse:
+ *
+ *  1. OFF UNLESS ASKED. `NUVIRA_OTEL=1` turns it on. With it off the SDK is
+ *     never even imported (`ensureProvider` is the only place that loads it), so
+ *     an ordinary run pays no startup cost and no span object is ever built. The
+ *     API package is a static import because that is exactly its design: with no
+ *     provider registered, every call through it is a no-op.
+ *
+ *  2. IT CAN NEVER BREAK THE RUN. Provider setup, attribute rendering and the
+ *     final flush are each best-effort, and the flush is BOUNDED — an
+ *     unreachable collector costs a turn at most one export timeout, once, and
+ *     never an exception. A tracer that can fail the turn it observes is worse
+ *     than no tracer. The bound is not a private constant: the standard
+ *     `OTEL_BSP_*` variables (`MAX_QUEUE_SIZE`, `SCHEDULE_DELAY`,
+ *     `MAX_EXPORT_BATCH_SIZE`, `EXPORT_TIMEOUT`) set both the batch processor and
+ *     the flush, with this module's defaults filling in the rest — see
+ *     {@link otelBatchSettings}.
+ *
+ *  3. IT CARRIES WHAT THE OTHER SINKS CARRY. Attribute values are previewed and
+ *     scrubbed with the SAME `scrubSecrets` the gateway log and the debug log
+ *     use, because a span is shipped to a third party by definition. Two regex
+ *     lists drift, and the one that drifts is the one that leaks.
+ *
+ * THE TREE, and what is deliberately not in it. A turn span (`nuvira.turn`) with
+ * one child per tool call that actually ran (`nuvira.tool.<name>`), plus the
+ * findings the turn recorded as span EVENTS — a finding has no duration, so it
+ * is a point-in-time fact rather than a span. There is no model-call span, and
+ * that is a measurement rather than an omission: the loop's event taxonomy
+ * (`tool`, `gate`, `refusal`, `decision`) has no model kind, so a model span
+ * could only be produced on some surfaces, and a tree that differs per surface
+ * is a tracing feature that lies. The missing span is the honest version; it is
+ * recorded here so the next person does not "fix" it by inventing one in
+ * `chat.ts` alone.
+ *
+ * PROPAGATION ACROSS THE FORK. A subagent is a separate process with its own
+ * provider, so its spans would be a second, unrelated trace by default. The
+ * spawner injects the ambient W3C `traceparent` into the child's environment
+ * (`childTraceEnv`) and the child resumes from it (`parentContextFromEnv`), so
+ * the child's turn span hangs off the tool call that spawned it and the whole
+ * thing is ONE trace. The parent comes from the ACTIVE context, never from
+ * module state: the loop makes the tool span active around the tool's execution,
+ * so two turns interleaving in one server process cannot hand each other's trace
+ * ids to a child. The turn's own parent is passed in explicitly for the same
+ * reason — reading it from `process.env` inside `startTurnSpan` would make every
+ * in-process surface inherit whatever a parent process happened to leave there.
+ */
+import { readFileSync } from 'node:fs';
+import { context, defaultTextMapGetter, defaultTextMapSetter, SpanKind, SpanStatusCode, trace, } from '@opentelemetry/api';
+// The W3C trace-context propagator, taken EXPLICITLY rather than through the
+// global one, and that choice is load-bearing. MEASURED: a forked child resolves
+// its parent BEFORE it registers a provider, and with nothing registered the API's
+// global propagator is the NOOP one — which returns the input context unchanged
+// and silently makes every child start a trace of its own. Using the same explicit
+// propagator on both sides of the fork makes the header a matched pair.
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+import { scrubSecrets } from '../gateway/gateway-log.js';
+/** The one propagator used to inject and extract the child's `traceparent`. */
+const w3cTraceContext = new W3CTraceContextPropagator();
+/** The env var suffix that turns span export on (`NUVIRA_OTEL=1`). */
+export const OTEL_ENABLE_ENV = 'OTEL';
+/**
+ * The env var a forked child is handed its parent's trace in.
+ *
+ * The VALUE is the W3C `traceparent` header, and the name is deliberately the
+ * conventional uppercase form of it — an environment variable, not a header.
+ */
+export const TRACEPARENT_ENV = 'TRACEPARENT';
+/**
+ * The W3C header name ITSELF, which is LOWERCASE, and that is not cosmetics.
+ *
+ * MEASURED: the propagator reads and writes the carrier by this exact key, so a
+ * carrier keyed `TRACEPARENT` is a carrier it cannot see — inject silently yields
+ * nothing and extract silently yields the input context, which is how every child
+ * ends up starting a trace of its own while everything still "works".
+ */
+const TRACEPARENT_HEADER = 'traceparent';
+/** The root span of a turn. One name on every surface, so a tree compares. */
+export const TURN_SPAN_NAME = 'nuvira.turn';
+/** Child span prefix for a tool call: `nuvira.tool.read_file`. */
+export const TOOL_SPAN_PREFIX = 'nuvira.tool.';
+/** The instrumentation scope name (what a collector shows as the source). */
+export const INSTRUMENTATION_NAME = 'agent-nuvira';
+/** Default `service.name`, overridable with `OTEL_SERVICE_NAME`. */
+export const DEFAULT_SERVICE_NAME = 'agent-nuvira';
+/** Attribute values are previews, not payloads — the longest line we ship. */
+export const OTEL_ATTR_PREVIEW_CHARS = 300;
+/**
+ * How long one export, and the flush that awaits it, may take.
+ *
+ * The DEFAULT for `OTEL_BSP_EXPORT_TIMEOUT` (which also bounds `flushSpans`), and
+ * the reason it is 3s rather than the SDK's 30s: a turn WAITS for its own spans to
+ * ship, and an unreachable collector must not hold an answer for half a minute.
+ * Raise the standard variable if a slow path to your collector needs longer.
+ */
+export const OTEL_FLUSH_TIMEOUT_MS = 3_000;
+/**
+ * Span queue bound, so a long-lived server cannot grow without limit.
+ *
+ * The DEFAULT for `OTEL_BSP_MAX_QUEUE_SIZE` (whose own spec default this is).
+ */
+export const OTEL_MAX_QUEUE = 2_048;
+/**
+ * How long the batch waits before shipping, in a process that keeps running.
+ *
+ * The DEFAULT for `OTEL_BSP_SCHEDULE_DELAY`. Faster than the SDK's 5s because a
+ * CLI turn is usually the whole process: the explicit flush at the end of a turn
+ * is what actually ships it, and this only bounds how long a long-running server
+ * holds a span it could have sent.
+ */
+export const OTEL_SCHEDULE_DELAY_MS = 1_000;
+/** The DEFAULT for `OTEL_BSP_MAX_EXPORT_BATCH_SIZE` (the SDK's own default). */
+export const OTEL_MAX_EXPORT_BATCH_SIZE = 512;
+/**
+ * The standard batch-processor variables this module honours, by field.
+ *
+ * WHY WE RESOLVE THEM OURSELVES. The SDK's `BatchSpanProcessor` does implement
+ * these fallbacks — but only for a config key left `undefined`, and this module
+ * passes its own defaults for all of them, so a user setting
+ * `OTEL_BSP_EXPORT_TIMEOUT=30000` would have been silently IGNORED. Reading the
+ * variables here keeps one precedence rule instead of two: an explicit value from
+ * the environment wins, the module's default fills the gap, and the SDK's own
+ * fallback then has nothing left to do.
+ */
+export const OTEL_BSP_VAR = {
+    maxQueueSize: 'OTEL_BSP_MAX_QUEUE_SIZE',
+    scheduledDelayMillis: 'OTEL_BSP_SCHEDULE_DELAY',
+    maxExportBatchSize: 'OTEL_BSP_MAX_EXPORT_BATCH_SIZE',
+    exportTimeoutMillis: 'OTEL_BSP_EXPORT_TIMEOUT',
+};
+/**
+ * One positive integer from the environment, or the fallback.
+ *
+ * A value that is set but unreadable (`abc`, `0`, `-5`, `1.5`) falls back rather
+ * than reaching the SDK: a queue of zero and a negative delay are both worse than
+ * the default, and neither is what the user meant to ask for.
+ */
+function positiveInt(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const n = Number(raw.trim());
+    return Number.isInteger(n) && n > 0 ? n : fallback;
+}
+/**
+ * The batch settings for this process: the standard `OTEL_BSP_*` variables where
+ * they are set, this module's defaults everywhere else.
+ *
+ * Exported so the resolution is testable on its own — the wiring is one call
+ * site, and a test that only exercised the resolver through a live collector
+ * could not tell a misparsed variable from a value the SDK ignored.
+ */
+export function otelBatchSettings(env = process.env) {
+    return {
+        maxQueueSize: positiveInt(env[OTEL_BSP_VAR.maxQueueSize], OTEL_MAX_QUEUE),
+        scheduledDelayMillis: positiveInt(env[OTEL_BSP_VAR.scheduledDelayMillis], OTEL_SCHEDULE_DELAY_MS),
+        maxExportBatchSize: positiveInt(env[OTEL_BSP_VAR.maxExportBatchSize], OTEL_MAX_EXPORT_BATCH_SIZE),
+        exportTimeoutMillis: positiveInt(env[OTEL_BSP_VAR.exportTimeoutMillis], OTEL_FLUSH_TIMEOUT_MS),
+    };
+}
+/** The variable a user sets to turn this on, spelled out for a message. */
+export const otelEnableVarName = `NUVIRA_${OTEL_ENABLE_ENV}`;
+/**
+ * Is span export on?
+ *
+ * `NUVIRA_OTEL` (or legacy `BUFF_OTEL`) set to anything other than the falsey
+ * words `0`, `false`, `off` or `no` enables it — the same rule the debug log
+ * uses, so `NUVIRA_OTEL=false` in an `.env` means off rather than "a non-empty
+ * string".
+ */
+export function otelExportEnabled(env = process.env) {
+    const raw = env[otelEnableVarName] ?? env[`BUFF_${OTEL_ENABLE_ENV}`];
+    if (raw === undefined)
+        return false;
+    const value = raw.trim().toLowerCase();
+    return value !== '' && value !== '0' && value !== 'false' && value !== 'off' && value !== 'no';
+}
+/**
+ * Where spans will be shipped — for a notice, and so a user who enabled export
+ * without an endpoint is told their spans are being built and dropped.
+ *
+ * Per the OTLP spec the TRACES variable is used verbatim and the generic one
+ * gets the signal path appended. The SDK does that resolution for us; this only
+ * has to say it out loud.
+ */
+export function otelEndpoint(env = process.env) {
+    const traces = env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT?.trim();
+    if (traces)
+        return traces;
+    const base = env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim();
+    if (!base)
+        return null;
+    return `${base.replace(/\/+$/, '')}/v1/traces`;
+}
+/** Cut a string to `max` chars, marking the cut so a reader knows it happened. */
+function cap(value, max) {
+    return value.length <= max ? value : `${value.slice(0, Math.max(0, max - 1))}…`;
+}
+/**
+ * One attribute value, safe to ship: flattened, cut, then redacted.
+ *
+ * OTLP accepts a scalar or an array of scalars, so anything else becomes a
+ * bounded JSON preview rather than being dropped — an attribute that silently
+ * vanishes is a debugging hole that only shows up when someone needs it. A
+ * circular structure returns a marker instead of throwing, because an
+ * instrument must never be the reason a turn fails.
+ */
+function attrValue(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : String(value);
+    if (typeof value === 'boolean')
+        return value;
+    if (Array.isArray(value)) {
+        const items = value
+            .filter((v) => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')
+            .slice(0, 20)
+            .map((v) => scrubSecrets(cap(String(v), OTEL_ATTR_PREVIEW_CHARS)));
+        return items.length > 0 ? items : undefined;
+    }
+    if (typeof value === 'string') {
+        return scrubSecrets(cap(value.replace(/\s+/g, ' ').trim(), OTEL_ATTR_PREVIEW_CHARS));
+    }
+    try {
+        const json = JSON.stringify(value, (_key, v) => typeof v === 'string' && v.length > 120 ? `${v.slice(0, 119)}…` : v);
+        return json === undefined ? undefined : scrubSecrets(cap(json, OTEL_ATTR_PREVIEW_CHARS));
+    }
+    catch {
+        return '[unrenderable]';
+    }
+}
+/** Turn a record of attributes into what OTLP wants, dropping absent values. */
+function attrRecord(attrs) {
+    const out = {};
+    for (const [key, value] of Object.entries(attrs)) {
+        const rendered = attrValue(value);
+        if (rendered !== undefined)
+            out[key] = rendered;
+    }
+    return out;
+}
+/** The real span wrapper. Private: callers program against {@link SpanHandle}. */
+class OtelSpanHandle {
+    ended = false;
+    record;
+    /**
+     * The context this span hangs under — its own span set as the active one, so
+     * a child nests correctly without depending on what is ambient at the time.
+     */
+    ownContext;
+    constructor(record, baseContext) {
+        this.record = record;
+        this.ownContext = trace.setSpan(baseContext, record);
+    }
+    get traceId() {
+        return this.record.spanContext().traceId;
+    }
+    get spanId() {
+        return this.record.spanContext().spanId;
+    }
+    /** The underlying span, for {@link withSpanActive}. Not part of the contract. */
+    get spanRecord() {
+        return this.record;
+    }
+    attr(key, value) {
+        const rendered = attrValue(value);
+        if (rendered === undefined)
+            return;
+        try {
+            this.record.setAttribute(key, rendered);
+        }
+        catch {
+            /* best-effort: an attribute must never break the turn it describes */
+        }
+    }
+    event(name, attrs = {}) {
+        try {
+            this.record.addEvent(name, attrRecord(attrs));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    child(name, attrs = {}) {
+        const record = trace.getTracer(INSTRUMENTATION_NAME).startSpan(name, { kind: SpanKind.INTERNAL, attributes: attrRecord(attrs) }, this.ownContext);
+        return new OtelSpanHandle(record, this.ownContext);
+    }
+    end(outcome = {}) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        try {
+            if (outcome.ok === false) {
+                this.record.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    ...(outcome.message ? { message: cap(outcome.message, OTEL_ATTR_PREVIEW_CHARS) } : {}),
+                });
+            }
+            else {
+                this.record.setStatus({ code: SpanStatusCode.OK });
+            }
+            this.record.end();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+let runtime = null;
+let starting = null;
+/**
+ * Build and register the provider the first time a span is asked for.
+ *
+ * The SDK is imported HERE rather than at module load, so a run that never
+ * enables export never pays for it — which is why `NUVIRA_OTEL` is a gate and
+ * not merely a flag that produces no spans.
+ */
+async function ensureProvider() {
+    if (!otelExportEnabled())
+        return null;
+    if (runtime)
+        return runtime;
+    if (!starting) {
+        starting = (async () => {
+            try {
+                const [{ NodeTracerProvider, BatchSpanProcessor }, { OTLPTraceExporter }, { resourceFromAttributes }] = await Promise.all([
+                    import('@opentelemetry/sdk-trace-node'),
+                    import('@opentelemetry/exporter-trace-otlp-http'),
+                    import('@opentelemetry/resources'),
+                ]);
+                const provider = new NodeTracerProvider({
+                    resource: resourceFromAttributes({
+                        'service.name': process.env.OTEL_SERVICE_NAME?.trim() || DEFAULT_SERVICE_NAME,
+                        'service.version': agentVersion() ?? 'unknown',
+                        // A forked child is its own process, and that is the isolation
+                        // boundary this project already documents — so a collector can tell
+                        // the parent's spans from the child's by instance id.
+                        'service.instance.id': String(process.pid),
+                    }),
+                    spanProcessors: [
+                        new BatchSpanProcessor(
+                        // No explicit url, headers or compression: the exporter reads the
+                        // standard `OTEL_EXPORTER_OTLP_*` variables itself, which is the
+                        // whole reason for depending on the SDK instead of re-implementing
+                        // its environment contract.
+                        new OTLPTraceExporter(), 
+                        // The standard `OTEL_BSP_*` variables, resolved here rather than
+                        // left to the SDK (whose fallbacks only fire for an ABSENT key).
+                        otelBatchSettings()),
+                    ],
+                });
+                provider.register();
+                runtime = { provider };
+                return runtime;
+            }
+            catch {
+                // A tracer that cannot start is a tracer that does not exist. The turn
+                // runs untraced, which is the honest degradation.
+                return null;
+            }
+        })();
+    }
+    return starting;
+}
+/**
+ * Start a turn's root span, or `null` when export is off.
+ *
+ * Async because the SDK loads on first use; every caller is already async.
+ */
+export async function startTurnSpan(options) {
+    const otel = await ensureProvider();
+    if (!otel)
+        return null;
+    try {
+        const base = options.parent ?? context.active();
+        const record = trace.getTracer(INSTRUMENTATION_NAME).startSpan(TURN_SPAN_NAME, {
+            // INTERNAL on every surface on purpose: this span is the agent TURN, and
+            // a turn is an internal operation wherever it runs. The inbound HTTP
+            // request or messaging event that triggered it is a different span owned
+            // by whoever accepted it, and giving each surface its own kind would
+            // make the tree differ per surface for no reader's benefit.
+            kind: SpanKind.INTERNAL,
+            attributes: {
+                'nuvira.surface': options.surface,
+                ...attrRecord({ 'nuvira.session': options.session, 'nuvira.goal': options.goal }),
+            },
+        }, base);
+        return new OtelSpanHandle(record, base);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The trace context a child process should continue, or `{}` when there is none.
+ *
+ * Read from the ACTIVE context, so the loop must have made the tool span active
+ * around the tool's execution. An empty object is the honest answer when nothing
+ * is active: a child handed a fabricated parent id would corrupt the trace it
+ * was supposed to join.
+ */
+export function childTraceEnv(env = process.env) {
+    if (!otelExportEnabled(env))
+        return {};
+    const active = trace.getSpan(context.active());
+    if (!active)
+        return {};
+    if (!trace.isSpanContextValid(active.spanContext()))
+        return {};
+    const carrier = {};
+    try {
+        w3cTraceContext.inject(trace.setSpan(context.active(), active), carrier, defaultTextMapSetter);
+    }
+    catch {
+        return {};
+    }
+    const injected = carrier[TRACEPARENT_HEADER];
+    return injected ? { [TRACEPARENT_ENV]: injected } : {};
+}
+/**
+ * The context a child process resumes from, or `null` when it was not told.
+ *
+ * A malformed or absent `traceparent` yields null rather than a guess, so a
+ * child started by hand simply begins a trace of its own.
+ */
+export function parentContextFromEnv(env = process.env) {
+    const traceparent = env[TRACEPARENT_ENV]?.trim();
+    if (!traceparent)
+        return null;
+    try {
+        const extracted = w3cTraceContext.extract(context.active(), { [TRACEPARENT_HEADER]: traceparent }, defaultTextMapGetter);
+        return trace.getSpanContext(extracted) ? extracted : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Run `fn` with `handle`'s span ACTIVE, so anything below it inherits the right
+ * parent — a tool that forks a subagent, or a library that is instrumented.
+ *
+ * Returns `fn`'s value unchanged, and a null handle simply runs `fn` with no
+ * added context: the disabled path costs one boolean.
+ */
+export function withSpanActive(handle, fn) {
+    if (!handle)
+        return fn();
+    const record = handle instanceof OtelSpanHandle ? handle.spanRecord : null;
+    if (!record)
+        return fn();
+    try {
+        return context.with(trace.setSpan(context.active(), record), fn);
+    }
+    catch {
+        return fn();
+    }
+}
+/**
+ * Ship what is buffered — bounded, and never throwing.
+ *
+ * Called at the end of a turn rather than relying on the scheduler, so a
+ * one-shot process (and a test) can observe the spans it just produced.
+ */
+export async function flushSpans() {
+    const otel = runtime;
+    if (!otel)
+        return;
+    try {
+        await Promise.race([
+            otel.provider.forceFlush(),
+            new Promise((resolve) => {
+                // A collector that accepted a request but never answered must not hold a
+                // turn open. Unref'd, so the timer itself cannot keep a CLI alive. The
+                // bound FOLLOWS the export timeout the user configured (`OTEL_BSP_
+                // EXPORT_TIMEOUT`) rather than being a second, independent number: a
+                // slower path to their collector must not be cut off by a limit they
+                // never set, and the flush can only ever wait as long as one export may.
+                const timer = setTimeout(resolve, otelBatchSettings().exportTimeoutMillis);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    catch {
+        // Dropped spans are the correct outcome for an unreachable collector.
+    }
+}
+/**
+ * Tear the provider down — only for a process that is about to exit.
+ *
+ * Deliberately NOT called at the end of every turn: in the dashboard and the
+ * gateway the provider has to outlive the turn it just traced. The one-shot
+ * surfaces (a `nuvira execute`, a forked subagent) call it so a lingering
+ * exporter socket cannot keep the process alive after the answer is printed.
+ *
+ * IT ALSO RELEASES THE API'S GLOBAL REGISTRATION, and that part is load-bearing
+ * rather than tidiness — MEASURED, the hard way. `provider.register()` puts this
+ * provider behind the API's process-wide proxy, and a provider that has been
+ * shut down still HAS that slot: the next `register()` cannot take it over, so
+ * `trace.getTracer()` keeps handing out tracers from the dead provider and every
+ * span built afterwards is silently dropped (the spans exist, carry real trace
+ * ids, and are never exported — the worst failure shape, because nothing errors
+ * and a collector shows an empty trace). Disabling the global provider and the
+ * global context manager is what lets tracing start again in the same process,
+ * which is exactly what a test harness that points several surfaces at several
+ * collectors does.
+ */
+export async function shutdownSpans() {
+    const otel = runtime;
+    if (!otel)
+        return;
+    runtime = null;
+    starting = null;
+    try {
+        await otel.provider.shutdown();
+    }
+    catch {
+        /* best-effort */
+    }
+    try {
+        trace.disable();
+        context.disable();
+    }
+    catch {
+        /* best-effort: an already-disabled global is not an error */
+    }
+}
+/**
+ * A one-line notice a surface can print, so a user knows spans are leaving.
+ *
+ * The no-endpoint case is the one worth printing: export is on, the tree is
+ * being built, and every span is being dropped — which looks exactly like a
+ * broken collector from the other side.
+ */
+export function otelNotice(surface, env = process.env) {
+    if (!otelExportEnabled(env))
+        return null;
+    const endpoint = otelEndpoint(env);
+    return endpoint
+        ? `🔭 ${surface}: OTLP spans → ${endpoint} (unset ${otelEnableVarName} to stop)`
+        : `🔭 ${surface}: span export is ON but no OTEL_EXPORTER_OTLP_ENDPOINT is set — spans are built and dropped. Set the endpoint to ship them.`;
+}
+/** Surfaces whose notice has already been printed in this process. */
+const noticesPrinted = new Set();
+/**
+ * {@link otelNotice}, but only the first time for a surface.
+ *
+ * A long-running server prints this once per process rather than once per turn:
+ * the destination does not change between turns, and a line per turn is noise
+ * nobody can act on. The CLI, with one turn, sees it exactly once either way.
+ */
+export function otelNoticeOnce(surface, env = process.env) {
+    const notice = otelNotice(surface, env);
+    if (!notice || noticesPrinted.has(surface))
+        return null;
+    noticesPrinted.add(surface);
+    return notice;
+}
+/** Running version, read the same best-effort way the debug log reads it. */
+let cachedVersion;
+function agentVersion() {
+    if (cachedVersion !== undefined)
+        return cachedVersion;
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf-8'));
+        cachedVersion = typeof pkg.version === 'string' && pkg.version.trim() ? pkg.version.trim() : null;
+    }
+    catch {
+        cachedVersion = null;
+    }
+    return cachedVersion;
+}
+//# sourceMappingURL=otel.js.map

package/dist/observability/otel.js.map

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