@loongsuite/otel-util-genai 0.1.0-beta.0

package/dist/handler.d.ts

@@ -0,0 +1,23 @@
+import { type Tracer, type TracerProvider, type MeterProvider, type Context } from "@opentelemetry/api";
+import { InvocationMetricsRecorder } from "./metrics.js";
+import { type EventLogger } from "./span-utils.js";
+import type { LLMInvocation, GenAIError } from "./types.js";
+export interface TelemetryHandlerOptions {
+    tracerProvider?: TracerProvider;
+    meterProvider?: MeterProvider;
+    loggerProvider?: unknown;
+    instrumentationName?: string;
+    instrumentationVersion?: string;
+}
+export declare class TelemetryHandler {
+    protected _tracer: Tracer;
+    protected _metricsRecorder: InvocationMetricsRecorder;
+    protected _logger: EventLogger | null;
+    constructor(options?: TelemetryHandlerOptions);
+    startLlm(invocation: LLMInvocation, parentContext?: Context, startTime?: number): LLMInvocation;
+    stopLlm(invocation: LLMInvocation, endTime?: number): LLMInvocation;
+    failLlm(invocation: LLMInvocation, error: GenAIError, endTime?: number): LLMInvocation;
+    llm<T>(invocationOrFn?: LLMInvocation | null, fn?: (inv: LLMInvocation) => T): T extends Promise<unknown> ? Promise<LLMInvocation> : LLMInvocation;
+}
+export declare function getTelemetryHandler(options?: TelemetryHandlerOptions): TelemetryHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAcA,OAAO,EAML,KAAK,MAAM,EAGX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM5D,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,gBAAgB;IAC3B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IACtD,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;gBAE1B,OAAO,GAAE,uBAA4B;IAiBjD,QAAQ,CACN,UAAU,EAAE,aAAa,EACzB,aAAa,CAAC,EAAE,OAAO,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa;IAkBhB,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa;IAWnE,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa;IActF,GAAG,CAAC,CAAC,EACH,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,EACrC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,GAC7B,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;CAgDvE;AA2BD,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAKlB"}

package/dist/handler.js

@@ -0,0 +1,127 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { trace, metrics, context, diag, SpanKind, } from "@opentelemetry/api";
+import { InvocationMetricsRecorder } from "./metrics.js";
+import { applyLlmFinishAttributes, applyErrorAttributes, maybeEmitLlmEvent, } from "./span-utils.js";
+import { createLLMInvocation } from "./types.js";
+import { VERSION } from "./version.js";
+const INSTRUMENTATION_NAME = "@loongsuite/otel-util-genai";
+export class TelemetryHandler {
+    _tracer;
+    _metricsRecorder;
+    _logger;
+    constructor(options = {}) {
+        const scopeName = options.instrumentationName ?? INSTRUMENTATION_NAME;
+        const scopeVersion = options.instrumentationVersion ?? VERSION;
+        this._tracer = (options.tracerProvider ?? trace).getTracer(scopeName, scopeVersion);
+        const meter = (options.meterProvider ?? metrics).getMeter(scopeName, scopeVersion);
+        this._metricsRecorder = new InvocationMetricsRecorder(meter);
+        // EventLogger from LoggerProvider (OTel Logs API)
+        this._logger = resolveEventLogger(options.loggerProvider, scopeName, scopeVersion);
+    }
+    startLlm(invocation, parentContext, startTime) {
+        const spanName = `${invocation.operationName ?? "chat"} ${invocation.requestModel ?? ""}`.trim();
+        const span = this._tracer.startSpan(spanName, { kind: SpanKind.CLIENT, startTime }, parentContext);
+        invocation.monotonicStartS = performance.now() / 1000;
+        invocation.span = span;
+        invocation.contextToken = trace.setSpan(parentContext ?? context.active(), span);
+        context.with(invocation.contextToken, () => { });
+        return invocation;
+    }
+    stopLlm(invocation, endTime) {
+        if (!invocation.span)
+            return invocation;
+        const span = invocation.span;
+        applyLlmFinishAttributes(span, invocation);
+        this._metricsRecorder.record(span, invocation);
+        maybeEmitLlmEvent(this._logger, span, invocation);
+        span.end(endTime);
+        return invocation;
+    }
+    failLlm(invocation, error, endTime) {
+        if (!invocation.span)
+            return invocation;
+        const span = invocation.span;
+        applyLlmFinishAttributes(span, invocation);
+        applyErrorAttributes(span, error);
+        this._metricsRecorder.record(span, invocation, {
+            errorType: error.type,
+        });
+        maybeEmitLlmEvent(this._logger, span, invocation, error);
+        span.end(endTime);
+        return invocation;
+    }
+    llm(invocationOrFn, fn) {
+        const invocation = invocationOrFn ?? createLLMInvocation();
+        this.startLlm(invocation);
+        if (!fn) {
+            // Return invocation for manual start/stop pattern when no callback
+            return invocation;
+        }
+        try {
+            const result = fn(invocation);
+            if (result instanceof Promise) {
+                return result
+                    .then(() => {
+                    this.stopLlm(invocation);
+                    return invocation;
+                })
+                    .catch((err) => {
+                    const genErr = {
+                        message: String(err),
+                        type: err instanceof Error
+                            ? err.constructor.name
+                            : "Error",
+                    };
+                    this.failLlm(invocation, genErr);
+                    throw err;
+                });
+            }
+            this.stopLlm(invocation);
+            return invocation;
+        }
+        catch (err) {
+            const genErr = {
+                message: String(err),
+                type: err instanceof Error ? err.constructor.name : "Error",
+            };
+            this.failLlm(invocation, genErr);
+            throw err;
+        }
+    }
+}
+function resolveEventLogger(loggerProvider, scopeName = INSTRUMENTATION_NAME, scopeVersion = VERSION) {
+    if (!loggerProvider)
+        return null;
+    if (typeof loggerProvider === "object" &&
+        loggerProvider !== null &&
+        "getLogger" in loggerProvider) {
+        try {
+            const lp = loggerProvider;
+            return lp.getLogger(scopeName, scopeVersion);
+        }
+        catch {
+            diag.debug("Failed to get event logger from LoggerProvider");
+        }
+    }
+    return null;
+}
+let _defaultHandler = null;
+export function getTelemetryHandler(options) {
+    if (!_defaultHandler) {
+        _defaultHandler = new TelemetryHandler(options);
+    }
+    return _defaultHandler;
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EACL,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,EACJ,QAAQ,GAOT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAU3D,MAAM,OAAO,gBAAgB;IACjB,OAAO,CAAS;IAChB,gBAAgB,CAA4B;IAC5C,OAAO,CAAqB;IAEtC,YAAY,UAAmC,EAAE;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;QACtE,MAAM,YAAY,GAAG,OAAO,CAAC,sBAAsB,IAAI,OAAO,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC,CAAC,SAAS,CACxD,SAAS,EACT,YAAY,CACb,CAAC;QACF,MAAM,KAAK,GAAU,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,CAAC,QAAQ,CAC9D,SAAS,EACT,YAAY,CACb,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAE7D,kDAAkD;QAClD,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACrF,CAAC;IAED,QAAQ,CACN,UAAyB,EACzB,aAAuB,EACvB,SAAkB;QAElB,MAAM,QAAQ,GACZ,GAAG,UAAU,CAAC,aAAa,IAAI,MAAM,IAAI,UAAU,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CACjC,QAAQ,EACR,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EACpC,aAAa,CACd,CAAC;QACF,UAAU,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACtD,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;QACvB,UAAU,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CACrC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,EACjC,IAAI,CACL,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,UAAyB,EAAE,OAAgB;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,UAAyB,EAAE,KAAiB,EAAE,OAAgB;QACpE,IAAI,CAAC,UAAU,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC3C,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE;YAC7C,SAAS,EAAE,KAAK,CAAC,IAAI;SACtB,CAAC,CAAC;QACH,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,GAAG,CACD,cAAqC,EACrC,EAA8B;QAE9B,MAAM,UAAU,GAAG,cAAc,IAAI,mBAAmB,EAAE,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE1B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,mEAAmE;YACnE,OAAO,UAEU,CAAC;QACpB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,OAAO,MAAM;qBACV,IAAI,CAAC,GAAG,EAAE;oBACT,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACzB,OAAO,UAAU,CAAC;gBACpB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;oBACtB,MAAM,MAAM,GAAe;wBACzB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;wBACpB,IAAI,EACF,GAAG,YAAY,KAAK;4BAClB,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI;4BACtB,CAAC,CAAC,OAAO;qBACd,CAAC;oBACF,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;oBACjC,MAAM,GAAG,CAAC;gBACZ,CAAC,CAEc,CAAC;YACpB,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACzB,OAAO,UAEU,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAe;gBACzB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;gBACpB,IAAI,EACF,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;aACxD,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACjC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED,SAAS,kBAAkB,CACzB,cAAuB,EACvB,YAAoB,oBAAoB,EACxC,eAAuB,OAAO;IAE9B,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,IACE,OAAO,cAAc,KAAK,QAAQ;QAClC,cAAc,KAAK,IAAI;QACvB,WAAW,IAAI,cAAc,EAC7B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,cAEV,CAAC;YACF,OAAO,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,eAAe,GAA4B,IAAI,CAAC;AAEpD,MAAM,UAAU,mBAAmB,CACjC,OAAiC;IAEjC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { VERSION } from "./version.js";
+export type { GenAIInvocation, LLMInvocation, GenAIError, InputMessage, OutputMessage, MessagePart, Text, Reasoning, ToolCall, ToolCallResponse, Blob, GenAIFile, Uri, Base64Blob, FunctionToolDefinition, GenericToolDefinition, ToolDefinition, Modality, FinishReason, } from "./types.js";
+export { ContentCapturingMode, createLLMInvocation } from "./types.js";
+export type { RetrievalDocument, EmbeddingInvocation, ExecuteToolInvocation, CreateAgentInvocation, InvokeAgentInvocation, RetrievalInvocation, RerankInvocation, EntryInvocation, ReactStepInvocation, } from "./extended-types.js";
+export { createEmbeddingInvocation, createExecuteToolInvocation, createCreateAgentInvocation, createInvokeAgentInvocation, createRetrievalInvocation, createRerankInvocation, createEntryInvocation, createReactStepInvocation, } from "./extended-types.js";
+export type { MemoryInvocation } from "./memory/memory-types.js";
+export { createMemoryInvocation } from "./memory/memory-types.js";
+export { TelemetryHandler, getTelemetryHandler, type TelemetryHandlerOptions, } from "./handler.js";
+export { ExtendedTelemetryHandler, getExtendedTelemetryHandler, } from "./extended-handler.js";
+export { isExperimentalMode, getContentCapturingMode, shouldEmitEvent, shouldCaptureContentInSpan, shouldCaptureContentInEvent, genAiJsonDumps, } from "./utils.js";
+export { createDurationHistogram, createTokenHistogram, } from "./instruments.js";
+export { InvocationMetricsRecorder } from "./metrics.js";
+export { ExtendedInvocationMetricsRecorder } from "./extended-metrics.js";
+export { getLlmCommonAttributes, getLlmSpanName, getLlmRequestAttributes, getLlmResponseAttributes, getLlmMessagesAttributesForSpan, getToolDefinitionsForSpan, applyLlmFinishAttributes, applyErrorAttributes, maybeEmitLlmEvent, type EventLogger, } from "./span-utils.js";
+export { applyEmbeddingFinishAttributes, applyCreateAgentFinishAttributes, applyExecuteToolFinishAttributes, applyInvokeAgentFinishAttributes, maybeEmitInvokeAgentEvent, applyRetrievalFinishAttributes, applyRerankFinishAttributes, applyEntryFinishAttributes, applyReactStepFinishAttributes, } from "./extended-span-utils.js";
+export { applyMemoryFinishAttributes, maybeEmitMemoryEvent, } from "./memory/memory-utils.js";
+export * from "./semconv/gen-ai-extended-attributes.js";
+export * from "./semconv/gen-ai-memory-attributes.js";
+export * from "./environment-variables.js";
+export * from "./extended-environment-variables.js";
+export * from "./event-log/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,YAAY,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,IAAI,EACJ,SAAS,EACT,GAAG,EACH,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGvE,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,gCAAgC,EAChC,gCAAgC,EAChC,yBAAyB,EACzB,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AAGpD,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Version
+export { VERSION } from "./version.js";
+export { ContentCapturingMode, createLLMInvocation } from "./types.js";
+export { createEmbeddingInvocation, createExecuteToolInvocation, createCreateAgentInvocation, createInvokeAgentInvocation, createRetrievalInvocation, createRerankInvocation, createEntryInvocation, createReactStepInvocation, } from "./extended-types.js";
+export { createMemoryInvocation } from "./memory/memory-types.js";
+// Handlers
+export { TelemetryHandler, getTelemetryHandler, } from "./handler.js";
+export { ExtendedTelemetryHandler, getExtendedTelemetryHandler, } from "./extended-handler.js";
+// Utilities
+export { isExperimentalMode, getContentCapturingMode, shouldEmitEvent, shouldCaptureContentInSpan, shouldCaptureContentInEvent, genAiJsonDumps, } from "./utils.js";
+// Instruments
+export { createDurationHistogram, createTokenHistogram, } from "./instruments.js";
+// Metrics
+export { InvocationMetricsRecorder } from "./metrics.js";
+export { ExtendedInvocationMetricsRecorder } from "./extended-metrics.js";
+// Span Utils
+export { getLlmCommonAttributes, getLlmSpanName, getLlmRequestAttributes, getLlmResponseAttributes, getLlmMessagesAttributesForSpan, getToolDefinitionsForSpan, applyLlmFinishAttributes, applyErrorAttributes, maybeEmitLlmEvent, } from "./span-utils.js";
+// Extended Span Utils
+export { applyEmbeddingFinishAttributes, applyCreateAgentFinishAttributes, applyExecuteToolFinishAttributes, applyInvokeAgentFinishAttributes, maybeEmitInvokeAgentEvent, applyRetrievalFinishAttributes, applyRerankFinishAttributes, applyEntryFinishAttributes, applyReactStepFinishAttributes, } from "./extended-span-utils.js";
+// Memory Utils
+export { applyMemoryFinishAttributes, maybeEmitMemoryEvent, } from "./memory/memory-utils.js";
+// Semantic Conventions
+export * from "./semconv/gen-ai-extended-attributes.js";
+export * from "./semconv/gen-ai-memory-attributes.js";
+// Environment Variables
+export * from "./environment-variables.js";
+export * from "./extended-environment-variables.js";
+// Event Log → Trace conversion
+export * from "./event-log/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAwBvC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAcvE,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,YAAY;AACZ,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,cAAc;AACd,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,UAAU;AACV,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE1E,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,iBAAiB,CAAC;AAEzB,sBAAsB;AACtB,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,gCAAgC,EAChC,gCAAgC,EAChC,yBAAyB,EACzB,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,eAAe;AACf,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,uBAAuB;AACvB,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AAEtD,wBAAwB;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AAEpD,+BAA+B;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/instruments.d.ts

@@ -0,0 +1,4 @@
+import type { Meter, Histogram } from "@opentelemetry/api";
+export declare function createDurationHistogram(meter: Meter): Histogram;
+export declare function createTokenHistogram(meter: Meter): Histogram;
+//# sourceMappingURL=instruments.d.ts.map

package/dist/instruments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.d.ts","sourceRoot":"","sources":["../src/instruments.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgB3D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAM/D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAO5D"}

package/dist/instruments.js

@@ -0,0 +1,37 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { GEN_AI_CLIENT_OPERATION_DURATION, GEN_AI_CLIENT_TOKEN_USAGE, } from "./semconv/gen-ai-extended-attributes.js";
+const DURATION_BUCKETS = [
+    0.01, 0.02, 0.04, 0.08, 0.16, 0.32, 0.64, 1.28, 2.56, 5.12, 10.24, 20.48,
+    40.96, 81.92,
+];
+const TOKEN_USAGE_BUCKETS = [
+    1, 4, 16, 64, 256, 1024, 4096, 16384, 65536, 262144, 1048576, 4194304,
+    16777216, 67108864,
+];
+export function createDurationHistogram(meter) {
+    return meter.createHistogram(GEN_AI_CLIENT_OPERATION_DURATION, {
+        description: "Duration of GenAI client operation",
+        unit: "s",
+        advice: { explicitBucketBoundaries: DURATION_BUCKETS },
+    });
+}
+export function createTokenHistogram(meter) {
+    return meter.createHistogram(GEN_AI_CLIENT_TOKEN_USAGE, {
+        description: "Number of input and output tokens used by GenAI clients",
+        unit: "{token}",
+        advice: { explicitBucketBoundaries: TOKEN_USAGE_BUCKETS },
+    });
+}
+//# sourceMappingURL=instruments.js.map

package/dist/instruments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.js","sourceRoot":"","sources":["../src/instruments.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAGjC,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AAEjD,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK;IACxE,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,MAAM,mBAAmB,GAAG;IAC1B,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACrE,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,KAAY;IAClD,OAAO,KAAK,CAAC,eAAe,CAAC,gCAAgC,EAAE;QAC7D,WAAW,EAAE,oCAAoC;QACjD,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,EAAE,wBAAwB,EAAE,gBAAgB,EAAE;KACvD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,OAAO,KAAK,CAAC,eAAe,CAAC,yBAAyB,EAAE;QACtD,WAAW,EACT,yDAAyD;QAC3D,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE,wBAAwB,EAAE,mBAAmB,EAAE;KAC1D,CAAC,CAAC;AACL,CAAC"}

package/dist/memory/memory-types.d.ts

@@ -0,0 +1,26 @@
+import type { Span, Context } from "@opentelemetry/api";
+export interface MemoryInvocation {
+    operation: string;
+    contextToken?: Context | null;
+    span?: Span | null;
+    attributes?: Record<string, unknown>;
+    userId?: string | null;
+    agentId?: string | null;
+    runId?: string | null;
+    appId?: string | null;
+    memoryId?: string | null;
+    limit?: number | null;
+    page?: number | null;
+    pageSize?: number | null;
+    topK?: number | null;
+    memoryType?: string | null;
+    threshold?: number | null;
+    rerank?: boolean | null;
+    inputMessages?: unknown;
+    outputMessages?: unknown;
+    serverAddress?: string | null;
+    serverPort?: number | null;
+    monotonicStartS?: number | null;
+}
+export declare function createMemoryInvocation(operation: string, init?: Partial<MemoryInvocation>): MemoryInvocation;
+//# sourceMappingURL=memory-types.d.ts.map

package/dist/memory/memory-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.d.ts","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC/B,gBAAgB,CAElB"}

package/dist/memory/memory-types.js

@@ -0,0 +1,17 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export function createMemoryInvocation(operation, init) {
+    return { operation, attributes: {}, ...init };
+}
+//# sourceMappingURL=memory-types.js.map

package/dist/memory/memory-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.js","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AA4BjC,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,IAAgC;IAEhC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC;AAChD,CAAC"}

package/dist/memory/memory-utils.d.ts

@@ -0,0 +1,7 @@
+import type { Span } from "@opentelemetry/api";
+import type { GenAIError } from "../types.js";
+import type { MemoryInvocation } from "./memory-types.js";
+import type { EventLogger } from "../span-utils.js";
+export declare function applyMemoryFinishAttributes(span: Span, invocation: MemoryInvocation): void;
+export declare function maybeEmitMemoryEvent(logger: EventLogger | null | undefined, span: Span, invocation: MemoryInvocation, error?: GenAIError | null): void;
+//# sourceMappingURL=memory-utils.d.ts.map

package/dist/memory/memory-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-utils.d.ts","sourceRoot":"","sources":["../../src/memory/memory-utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA0B1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAyFpD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAwBN;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,gBAAgB,EAC5B,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GACxB,IAAI,CAgBN"}

package/dist/memory/memory-utils.js

@@ -0,0 +1,121 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { GEN_AI_OPERATION_NAME, GEN_AI_SPAN_KIND, SERVER_ADDRESS, SERVER_PORT, ERROR_TYPE, GenAiSpanKindValues, } from "../semconv/gen-ai-extended-attributes.js";
+import { GEN_AI_MEMORY_OPERATION, GEN_AI_MEMORY_USER_ID, GEN_AI_MEMORY_AGENT_ID, GEN_AI_MEMORY_RUN_ID, GEN_AI_MEMORY_APP_ID, GEN_AI_MEMORY_ID, GEN_AI_MEMORY_LIMIT, GEN_AI_MEMORY_PAGE, GEN_AI_MEMORY_PAGE_SIZE, GEN_AI_MEMORY_TOP_K, GEN_AI_MEMORY_MEMORY_TYPE, GEN_AI_MEMORY_THRESHOLD, GEN_AI_MEMORY_RERANK, GEN_AI_MEMORY_INPUT_MESSAGES, GEN_AI_MEMORY_OUTPUT_MESSAGES, } from "../semconv/gen-ai-memory-attributes.js";
+import { isExperimentalMode, shouldEmitEvent, shouldCaptureContentInSpan, shouldCaptureContentInEvent, genAiJsonDumps, } from "../utils.js";
+function getMemoryCommonAttributes(invocation) {
+    const attrs = {
+        [GEN_AI_OPERATION_NAME]: "memory_operation",
+        [GEN_AI_MEMORY_OPERATION]: invocation.operation,
+    };
+    if (invocation.userId != null) {
+        attrs[GEN_AI_MEMORY_USER_ID] = invocation.userId;
+    }
+    if (invocation.agentId != null) {
+        attrs[GEN_AI_MEMORY_AGENT_ID] = invocation.agentId;
+    }
+    if (invocation.runId != null) {
+        attrs[GEN_AI_MEMORY_RUN_ID] = invocation.runId;
+    }
+    if (invocation.appId != null) {
+        attrs[GEN_AI_MEMORY_APP_ID] = invocation.appId;
+    }
+    return attrs;
+}
+function getMemoryParameterAttributes(invocation) {
+    const attrs = {};
+    if (invocation.memoryId != null) {
+        attrs[GEN_AI_MEMORY_ID] = invocation.memoryId;
+    }
+    if (invocation.limit != null) {
+        attrs[GEN_AI_MEMORY_LIMIT] = invocation.limit;
+    }
+    if (invocation.page != null) {
+        attrs[GEN_AI_MEMORY_PAGE] = invocation.page;
+    }
+    if (invocation.pageSize != null) {
+        attrs[GEN_AI_MEMORY_PAGE_SIZE] = invocation.pageSize;
+    }
+    if (invocation.topK != null) {
+        attrs[GEN_AI_MEMORY_TOP_K] = invocation.topK;
+    }
+    if (invocation.memoryType != null) {
+        attrs[GEN_AI_MEMORY_MEMORY_TYPE] = invocation.memoryType;
+    }
+    if (invocation.threshold != null) {
+        attrs[GEN_AI_MEMORY_THRESHOLD] = invocation.threshold;
+    }
+    if (invocation.rerank != null) {
+        attrs[GEN_AI_MEMORY_RERANK] = invocation.rerank;
+    }
+    return attrs;
+}
+function getMemoryContentAttributes(invocation, forSpan) {
+    if (!isExperimentalMode())
+        return {};
+    if (forSpan && !shouldCaptureContentInSpan())
+        return {};
+    if (!forSpan && !shouldCaptureContentInEvent())
+        return {};
+    const attrs = {};
+    if (invocation.inputMessages != null) {
+        attrs[GEN_AI_MEMORY_INPUT_MESSAGES] =
+            typeof invocation.inputMessages === "string"
+                ? invocation.inputMessages
+                : genAiJsonDumps(invocation.inputMessages);
+    }
+    if (invocation.outputMessages != null) {
+        attrs[GEN_AI_MEMORY_OUTPUT_MESSAGES] =
+            typeof invocation.outputMessages === "string"
+                ? invocation.outputMessages
+                : genAiJsonDumps(invocation.outputMessages);
+    }
+    return attrs;
+}
+export function applyMemoryFinishAttributes(span, invocation) {
+    span.updateName(invocation.operation
+        ? `memory_operation ${invocation.operation}`
+        : "memory_operation");
+    span.setAttribute(GEN_AI_SPAN_KIND, GenAiSpanKindValues.MEMORY);
+    const attrs = {};
+    Object.assign(attrs, getMemoryCommonAttributes(invocation));
+    Object.assign(attrs, getMemoryParameterAttributes(invocation));
+    if (invocation.serverAddress != null) {
+        attrs[SERVER_ADDRESS] = invocation.serverAddress;
+    }
+    if (invocation.serverPort != null) {
+        attrs[SERVER_PORT] = invocation.serverPort;
+    }
+    Object.assign(attrs, getMemoryContentAttributes(invocation, true));
+    if (invocation.attributes) {
+        Object.assign(attrs, invocation.attributes);
+    }
+    span.setAttributes(attrs);
+}
+export function maybeEmitMemoryEvent(logger, span, invocation, error) {
+    if (!isExperimentalMode() || !shouldEmitEvent() || !logger)
+        return;
+    const attrs = {};
+    Object.assign(attrs, getMemoryCommonAttributes(invocation));
+    Object.assign(attrs, getMemoryParameterAttributes(invocation));
+    Object.assign(attrs, getMemoryContentAttributes(invocation, false));
+    if (error) {
+        attrs[ERROR_TYPE] = error.type;
+    }
+    logger.emit({
+        name: "gen_ai.memory.operation.details",
+        attributes: attrs,
+    });
+}
+//# sourceMappingURL=memory-utils.js.map

package/dist/memory/memory-utils.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,11 @@
+import type { Meter, Span } from "@opentelemetry/api";
+import type { LLMInvocation } from "./types.js";
+export declare class InvocationMetricsRecorder {
+    private _durationHistogram;
+    private _tokenHistogram;
+    constructor(meter: Meter);
+    record(span: Span | null | undefined, invocation: LLMInvocation, options?: {
+        errorType?: string;
+    }): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAa,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAMjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAchD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,eAAe,CAAY;gBAEvB,KAAK,EAAE,KAAK;IAKxB,MAAM,CACJ,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAC7B,UAAU,EAAE,aAAa,EACzB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,IAAI;CAiER"}

package/dist/metrics.js

@@ -0,0 +1,77 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { trace, context } from "@opentelemetry/api";
+import { createDurationHistogram, createTokenHistogram, } from "./instruments.js";
+import { GEN_AI_OPERATION_NAME, GEN_AI_REQUEST_MODEL, GEN_AI_PROVIDER_NAME, GEN_AI_RESPONSE_MODEL, GEN_AI_TOKEN_TYPE, GenAiOperationNameValues, GenAiTokenTypeValues, SERVER_ADDRESS, SERVER_PORT, ERROR_TYPE, } from "./semconv/gen-ai-extended-attributes.js";
+export class InvocationMetricsRecorder {
+    _durationHistogram;
+    _tokenHistogram;
+    constructor(meter) {
+        this._durationHistogram = createDurationHistogram(meter);
+        this._tokenHistogram = createTokenHistogram(meter);
+    }
+    record(span, invocation, options) {
+        if (!span)
+            return;
+        const tokenCounts = [];
+        if (invocation.inputTokens != null) {
+            tokenCounts.push({
+                count: invocation.inputTokens,
+                type: GenAiTokenTypeValues.INPUT,
+            });
+        }
+        if (invocation.outputTokens != null) {
+            tokenCounts.push({
+                count: invocation.outputTokens,
+                type: GenAiTokenTypeValues.OUTPUT,
+            });
+        }
+        const attributes = {
+            [GEN_AI_OPERATION_NAME]: GenAiOperationNameValues.CHAT,
+        };
+        if (invocation.requestModel) {
+            attributes[GEN_AI_REQUEST_MODEL] = invocation.requestModel;
+        }
+        if (invocation.provider) {
+            attributes[GEN_AI_PROVIDER_NAME] = invocation.provider;
+        }
+        if (invocation.responseModelName) {
+            attributes[GEN_AI_RESPONSE_MODEL] = invocation.responseModelName;
+        }
+        if (invocation.serverAddress) {
+            attributes[SERVER_ADDRESS] = invocation.serverAddress;
+        }
+        if (invocation.serverPort != null) {
+            attributes[SERVER_PORT] = invocation.serverPort;
+        }
+        if (invocation.metricAttributes) {
+            Object.assign(attributes, invocation.metricAttributes);
+        }
+        let durationSeconds = null;
+        if (invocation.monotonicStartS != null) {
+            durationSeconds = Math.max(performance.now() / 1000 - invocation.monotonicStartS, 0.0);
+        }
+        const spanContext = trace.setSpan(context.active(), span);
+        if (options?.errorType) {
+            attributes[ERROR_TYPE] = options.errorType;
+        }
+        if (durationSeconds != null) {
+            this._durationHistogram.record(durationSeconds, attributes, spanContext);
+        }
+        for (const { count, type } of tokenCounts) {
+            this._tokenHistogram.record(count, { ...attributes, [GEN_AI_TOKEN_TYPE]: type }, spanContext);
+        }
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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