autotel 6.2.0 → 6.3.0

package/README.md

@@ -36,6 +36,7 @@ Replace `NODE_OPTIONS` and 30+ lines of SDK boilerplate with `init()`, wrap func
   - [LLM Observability with OpenLLMetry](#llm-observability-with-openllmetry)
     - [Installation](#installation)
     - [Usage](#usage)
+    - [Using the Vercel AI SDK?](#using-the-vercel-ai-sdk)
   - [Sampling](#sampling)
     - [Preset Shorthand](#preset-shorthand)
     - [Tuned Presets](#tuned-presets)
@@ -394,6 +395,33 @@ OpenLLMetry will automatically:
 
 All LLM spans will appear alongside your application traces in your observability backend.
 
+### Using the Vercel AI SDK?
+
+OpenLLMetry instruments provider SDKs. It does not see the AI SDK, which runs
+its own telemetry pipeline, so `generateText`, `streamText` and `embed` produce
+no spans through the section above.
+
+The AI SDK's `telemetry: { functionId }` option does nothing on its own either.
+It emits lifecycle events, and something has to be registered to listen.
+Register [`autotel-genai`](../autotel-genai) once at startup, next to `init()`:
+
+```typescript
+import { registerTelemetry } from 'ai';
+import { init } from 'autotel';
+import { autotelTelemetry } from 'autotel-genai/observer';
+
+init({ service: 'my-llm-app', endpoint: process.env.OTLP_ENDPOINT });
+registerTelemetry(autotelTelemetry());
+```
+
+Every `generateText` / `streamText` / `embed` call now streams a canonical
+`gen_ai.*` span tree with token usage, cost and streaming timing.
+
+Miss that line and nothing breaks and nothing warns: the calls run, the app
+works, and every LLM span is silently absent. If `get_llm_usage` in
+[`autotel-mcp`](../autotel-mcp) reports zero requests while your app is plainly
+calling a model, this is why.
+
 **AI Workflow Patterns:** See [AI/LLM Workflow Documentation](../../docs/AI_WORKFLOWS.md) for comprehensive patterns including:
 
 - Multi-agent workflows (orchestration and handoffs)
@@ -2586,7 +2614,28 @@ export async function handleRequest(req: Request) {
 
 ## Serverless & Short-lived Processes
 
-For serverless environments (AWS Lambda, Vercel, Cloud Functions) and other short-lived processes, telemetry may not export before the process ends. Autotel provides two approaches:
+A script that finishes and returns gets one flush for free. Autotel listens for
+`beforeExit`, so a CLI, a cron job or a CI step keeps its telemetry without
+calling anything:
+
+```typescript
+init({ service: 'my-cli' });
+await doWork();
+// event loop drains -> autotel flushes -> process exits
+```
+
+Turn it off with `flushOnExit: false` if your process manages its own exit and
+you would rather autotel added no listener.
+
+It flushes rather than shutting down — `beforeExit` fires on any event-loop
+drain, so a process that goes on to do more work keeps its telemetry — and it is
+bounded by `processHandlers.shutdownTimeoutMs` (default 2s), after which the
+process exits instead of waiting on an exporter that never answers.
+
+`beforeExit` does not fire on `process.exit()`, on a signal, or after an
+uncaught exception. For those, and for serverless (AWS Lambda, Vercel, Cloud
+Functions) where the runtime freezes the process between invocations rather
+than ending it, reach for one of these:
 
 ### Manual Flush (Recommended for Serverless)
 

package/dist/auto.cjs

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 const require_yaml_config = require('./yaml-config.cjs');
 let node_module = require("node:module");
 node_module = require_rolldown_runtime.__toESM(node_module, 1);

package/dist/auto.js

@@ -1,4 +1,4 @@
-import { i as init } from "./init-DDkh2brw.js";
+import { i as init } from "./init-Qn4gIW1i.js";
 import { loadYamlConfig } from "./yaml-config.js";
 import * as nodeModule from "node:module";
 import { createAddHookMessageChannel } from "import-in-the-middle";

package/dist/config.cjs

@@ -36,6 +36,8 @@ const FEATURE_FLAGS = {
 * Internal configuration state
 */
 var Config = class {
+	/** Set when a caller passes a Meter instance, which then wins over the name. */
+	customMeter = false;
 	config = {
 		tracerName: "app",
 		meterName: "app",
@@ -61,18 +63,23 @@ var Config = class {
 			this.config.meter = _opentelemetry_api.metrics.getMeter(options.meterName);
 		}
 		if (options.tracer) this.config.tracer = options.tracer;
-		if (options.meter) this.config.meter = options.meter;
+		if (options.meter) {
+			this.config.meter = options.meter;
+			this.customMeter = true;
+		}
 	}
 	/**
 	* Get current configuration
 	*/
 	get() {
+		if (!this.customMeter) this.config.meter = _opentelemetry_api.metrics.getMeter(this.config.meterName);
 		return this.config;
 	}
 	/**
 	* Reset to defaults (mainly for testing)
 	*/
 	reset() {
+		this.customMeter = false;
 		this.config = {
 			tracerName: "app",
 			meterName: "app",

package/dist/config.js

@@ -35,6 +35,8 @@ const FEATURE_FLAGS = {
 * Internal configuration state
 */
 var Config = class {
+	/** Set when a caller passes a Meter instance, which then wins over the name. */
+	customMeter = false;
 	config = {
 		tracerName: "app",
 		meterName: "app",
@@ -60,18 +62,23 @@ var Config = class {
 			this.config.meter = metrics.getMeter(options.meterName);
 		}
 		if (options.tracer) this.config.tracer = options.tracer;
-		if (options.meter) this.config.meter = options.meter;
+		if (options.meter) {
+			this.config.meter = options.meter;
+			this.customMeter = true;
+		}
 	}
 	/**
 	* Get current configuration
 	*/
 	get() {
+		if (!this.customMeter) this.config.meter = metrics.getMeter(this.config.meterName);
 		return this.config;
 	}
 	/**
 	* Reset to defaults (mainly for testing)
 	*/
 	reset() {
+		this.customMeter = false;
 		this.config = {
 			tracerName: "app",
 			meterName: "app",

package/dist/correlation-id.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 
 exports.CORRELATION_ID_BAGGAGE_KEY = require_init.CORRELATION_ID_BAGGAGE_KEY;
 exports.generateCorrelationId = require_init.generateCorrelationId;

package/dist/correlation-id.js

@@ -1,3 +1,3 @@
-import { C as setCorrelationId, S as runWithCorrelationId, _ as CORRELATION_ID_BAGGAGE_KEY, b as getCorrelationStorage, v as generateCorrelationId, w as setCorrelationIdInBaggage, x as getOrCreateCorrelationId, y as getCorrelationId } from "./init-DDkh2brw.js";
+import { C as setCorrelationId, S as runWithCorrelationId, _ as CORRELATION_ID_BAGGAGE_KEY, b as getCorrelationStorage, v as generateCorrelationId, w as setCorrelationIdInBaggage, x as getOrCreateCorrelationId, y as getCorrelationId } from "./init-Qn4gIW1i.js";
 
 export { CORRELATION_ID_BAGGAGE_KEY, generateCorrelationId, getCorrelationId, getCorrelationStorage, getOrCreateCorrelationId, runWithCorrelationId, setCorrelationId, setCorrelationIdInBaggage };

package/dist/decorators.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_config = require('./config.cjs');
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/decorators.ts

package/dist/decorators.js

@@ -1,5 +1,5 @@
 import { getConfig } from "./config.js";
-import { T as createTraceContext } from "./init-DDkh2brw.js";
+import { T as createTraceContext } from "./init-Qn4gIW1i.js";
 import { SpanStatusCode } from "@opentelemetry/api";
 
 //#region src/decorators.ts

package/dist/event.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 
 exports.Event = require_init.Event;
 exports.getEvents = require_init.getEvents;

package/dist/event.js

@@ -1,3 +1,3 @@
-import { d as getEvents, f as resetEvents, u as Event } from "./init-DDkh2brw.js";
+import { d as getEvents, f as resetEvents, u as Event } from "./init-Qn4gIW1i.js";
 
 export { Event, getEvents, resetEvents };

package/dist/{functional-DYAZiYxr.js → functional-DCBhFool.js}

@@ -1,7 +1,7 @@
 import { getForceFlushableProvider } from "./tracer-provider.js";
 import { getConfig } from "./config.js";
 import { AUTOTEL_SAMPLING_RATE, AUTOTEL_SAMPLING_TAIL_EVALUATED, AUTOTEL_SAMPLING_TAIL_KEEP, AlwaysSampler } from "./sampling.js";
-import { D as getActiveContextWithBaggage, O as getContextStorage, T as createTraceContext, h as getEventQueue, m as runInOperationContext, r as getSdk, t as getConfig$1 } from "./init-DDkh2brw.js";
+import { D as getActiveContextWithBaggage, O as getContextStorage, T as createTraceContext, h as getEventQueue, m as runInOperationContext, r as getSdk, t as getConfig$1 } from "./init-Qn4gIW1i.js";
 import { setSpanName } from "./trace-helpers.js";
 import { SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
 import * as nodeFs from "node:fs";

package/dist/{functional-D545J0Ba.cjs → functional-TbnG2lu7.cjs}

@@ -2,7 +2,7 @@ const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
 const require_tracer_provider = require('./tracer-provider.cjs');
 const require_config = require('./config.cjs');
 const require_sampling = require('./sampling.cjs');
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 let node_fs = require("node:fs");

package/dist/functional.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_functional = require('./functional-D545J0Ba.cjs');
+const require_functional = require('./functional-TbnG2lu7.cjs');
 
 exports.ctx = require_functional.ctx;
 exports.getActiveTraceContext = require_functional.getActiveTraceContext;

package/dist/functional.js

@@ -1,3 +1,3 @@
-import { a as trace, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-DYAZiYxr.js";
+import { a as trace, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-DCBhFool.js";
 
 export { ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };

package/dist/http.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_config = require('./config.cjs');
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/http.ts

package/dist/http.js

@@ -1,5 +1,5 @@
 import { getConfig } from "./config.js";
-import { D as getActiveContextWithBaggage } from "./init-DDkh2brw.js";
+import { D as getActiveContextWithBaggage } from "./init-Qn4gIW1i.js";
 import { SpanStatusCode, context, propagation } from "@opentelemetry/api";
 
 //#region src/http.ts

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
 const require_tracer_provider = require('./tracer-provider.cjs');
 const require_sampling = require('./sampling.cjs');
-const require_init = require('./init-CzNFWUd8.cjs');
+const require_init = require('./init-BneZ7WJ8.cjs');
 const require_filtering_span_processor = require('./filtering-span-processor.cjs');
 const require_span_name_normalizer = require('./span-name-normalizer.cjs');
 const require_attribute_redacting_processor = require('./attribute-redacting-processor.cjs');
@@ -10,7 +10,7 @@ const require_canonical_log_line_processor = require('./canonical-log-line-proce
 const require_structured_error = require('./structured-error-CHg7DoIQ.cjs');
 const require_metric = require('./metric.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
-const require_functional = require('./functional-D545J0Ba.cjs');
+const require_functional = require('./functional-TbnG2lu7.cjs');
 const require_stable_hash = require('./stable-hash-CS9BxvVQ.cjs');
 const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
 const require_parse_error = require('./parse-error.cjs');

package/dist/index.d.cts

@@ -9,7 +9,7 @@ import { DrainPipelineOptions, PipelineDrainFn, createDrainPipeline } from "./dr
 import { a as EventSubscriber, c as OutcomeStatus, i as EventSchemaMetadata, n as EventAttributes, o as EventTrackingOptions, s as FunnelStatus, t as AutotelEventContext } from "./event-subscriber-CWh8sTGh.cjs";
 import { Event, EventsOptions, getEvents, resetEvents } from "./event.cjs";
 import { n as FilteringSpanProcessorOptions, r as SpanFilterPredicate, t as FilteringSpanProcessor } from "./filtering-span-processor-BpDagWNa.cjs";
-import { a as isLoggerLocked, c as StringRedactor, i as isInitialized, l as createStringRedactor, o as lockLogger, r as init, s as ProcessHandlersConfig, t as AutotelConfig } from "./init-BoIYyB6Q.cjs";
+import { a as AutotelConfig, c as StringRedactor, i as lockLogger, l as createStringRedactor, n as isInitialized, r as isLoggerLocked, s as ProcessHandlersConfig, t as init } from "./init-CfVWN4ND.cjs";
 import { a as SpanNameNormalizerPreset, i as SpanNameNormalizerFn, n as NORMALIZER_PRESETS, o as SpanNameNormalizingProcessor, r as SpanNameNormalizerConfig, s as SpanNameNormalizingProcessorOptions, t as NORMALIZER_PATTERNS } from "./span-name-normalizer-CN1-8C76.cjs";
 import "./canonical-log-line-processor-B4WgG-VS.cjs";
 import { i as defineEvent, n as DefinedEvent, r as SchemaLike, t as DefineEventOptions } from "./define-event-CGG048HE.cjs";

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import { DrainPipelineOptions, PipelineDrainFn, createDrainPipeline } from "./dr
 import { a as EventSubscriber, c as OutcomeStatus, i as EventSchemaMetadata, n as EventAttributes, o as EventTrackingOptions, s as FunnelStatus, t as AutotelEventContext } from "./event-subscriber-CWh8sTGh.js";
 import { Event, EventsOptions, getEvents, resetEvents } from "./event.js";
 import { n as FilteringSpanProcessorOptions, r as SpanFilterPredicate, t as FilteringSpanProcessor } from "./filtering-span-processor-BpDagWNa.js";
-import { a as isLoggerLocked, c as StringRedactor, i as isInitialized, l as createStringRedactor, o as lockLogger, r as init, s as ProcessHandlersConfig, t as AutotelConfig } from "./init-BHp-kqLJ.js";
+import { a as AutotelConfig, c as StringRedactor, i as lockLogger, l as createStringRedactor, n as isInitialized, r as isLoggerLocked, s as ProcessHandlersConfig, t as init } from "./init-C1i2_2zl.js";
 import { a as SpanNameNormalizerPreset, i as SpanNameNormalizerFn, n as NORMALIZER_PRESETS, o as SpanNameNormalizingProcessor, r as SpanNameNormalizerConfig, s as SpanNameNormalizingProcessorOptions, t as NORMALIZER_PATTERNS } from "./span-name-normalizer-CN1-8C76.js";
 import "./canonical-log-line-processor-CL_J7gb5.js";
 import { i as defineEvent, n as DefinedEvent, r as SchemaLike, t as DefineEventOptions } from "./define-event-B2z1SBe7.js";

package/dist/index.js

@@ -1,6 +1,6 @@
 import { getAutotelTracer, getAutotelTracerProvider, setAutotelTracerProvider } from "./tracer-provider.js";
 import { AUTOTEL_SAMPLING_TAIL_EVALUATED, AUTOTEL_SAMPLING_TAIL_KEEP, AdaptiveSampler, AlwaysSampler, NeverSampler, RandomSampler, UserIdSampler, createLinkFromHeaders, extractLinksFromBatch, resolveSamplingPreset, samplingPresets } from "./sampling.js";
-import { A as BaggageSpanProcessor, C as setCorrelationId, E as defineBaggageSchema, S as runWithCorrelationId, T as createTraceContext, _ as CORRELATION_ID_BAGGAGE_KEY, a as isInitialized, c as flush, d as getEvents, f as resetEvents, g as track, h as getEventQueue, i as init, k as createStringRedactor, l as shutdown, m as runInOperationContext, o as isLoggerLocked, p as getOperationContext, s as lockLogger, u as Event, v as generateCorrelationId, w as setCorrelationIdInBaggage, x as getOrCreateCorrelationId, y as getCorrelationId } from "./init-DDkh2brw.js";
+import { A as BaggageSpanProcessor, C as setCorrelationId, E as defineBaggageSchema, S as runWithCorrelationId, T as createTraceContext, _ as CORRELATION_ID_BAGGAGE_KEY, a as isInitialized, c as flush, d as getEvents, f as resetEvents, g as track, h as getEventQueue, i as init, k as createStringRedactor, l as shutdown, m as runInOperationContext, o as isLoggerLocked, p as getOperationContext, s as lockLogger, u as Event, v as generateCorrelationId, w as setCorrelationIdInBaggage, x as getOrCreateCorrelationId, y as getCorrelationId } from "./init-Qn4gIW1i.js";
 import { FilteringSpanProcessor } from "./filtering-span-processor.js";
 import { NORMALIZER_PATTERNS, NORMALIZER_PRESETS, SpanNameNormalizingProcessor } from "./span-name-normalizer.js";
 import { AttributeRedactingProcessor, REDACTOR_PATTERNS, REDACTOR_PRESETS, builtinPatterns, createAttributeRedactor, createRedactedSpan, normalizeAttributeRedactorConfig } from "./attribute-redacting-processor.js";
@@ -8,7 +8,7 @@ import { n as formatDuration } from "./canonical-log-line-processor-mKABvGP0.js"
 import { a as flattenToAttributes, i as structuredErrorToJSON, n as getStructuredErrorAttributes, o as toAttributeValue, r as recordStructuredError, t as createStructuredError } from "./structured-error-9--cxBay.js";
 import { Metric, getMetrics, resetMetrics } from "./metric.js";
 import { createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan } from "./trace-helpers.js";
-import { a as trace$2, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-DYAZiYxr.js";
+import { a as trace$2, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-DCBhFool.js";
 import { t as hashJson } from "./stable-hash-ChFBIhNt.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
 import { parseError } from "./parse-error.js";