@microsoft/opentelemetry 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/esm/a365/processors/PerRequestSpanProcessor.js

@@ -0,0 +1,256 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Buffers spans per trace and exports once the request completes.
+ * Token is not stored; we export under the saved request Context so that
+ * getExportToken() can read the token from the active OpenTelemetry Context at export time.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/PerRequestSpanProcessor.ts
+ */
+import { context, trace } from "@opentelemetry/api";
+import { Logger } from "../../shared/logging/index.js";
+const logger = Logger.getInstance();
+function isRootSpan(span) {
+    return !span.parentSpanContext;
+}
+/**
+ * Check whether this span is a root span by examining the parent context.
+ * In onStart, the SDK passes a live Span (not ReadableSpan), so we check
+ * whether the parent context already contains a span.
+ */
+function isRootSpanFromContext(ctx) {
+    const parentSpan = trace.getSpan(ctx);
+    return !parentSpan;
+}
+// Default values
+const DEFAULT_MAX_BUFFERED_TRACES = 1000;
+const DEFAULT_MAX_SPANS_PER_TRACE = 5000;
+const DEFAULT_MAX_CONCURRENT_EXPORTS = 20;
+const DEFAULT_FLUSH_GRACE_MS = 250;
+const DEFAULT_MAX_TRACE_AGE_MS = 1800000; // 30 minutes
+function parseEnvInt(envVar, defaultValue) {
+    if (envVar === undefined || envVar === "")
+        return defaultValue;
+    const parsed = parseInt(envVar, 10);
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Buffers spans per trace and exports them together once the trace completes.
+ *
+ * This processor supports per-request token resolution by exporting under
+ * the original request Context so that getExportToken() can read the token
+ * from the active OpenTelemetry Context at export time.
+ */
+export class PerRequestSpanProcessor {
+    exporter;
+    traces = new Map();
+    sweepTimer;
+    isSweeping = false;
+    maxBufferedTraces;
+    maxSpansPerTrace;
+    maxConcurrentExports;
+    flushGraceMs;
+    maxTraceAgeMs;
+    inFlightExports = 0;
+    exportWaiters = [];
+    constructor(exporter, options) {
+        this.exporter = exporter;
+        this.maxBufferedTraces = parseEnvInt(process.env.A365_PER_REQUEST_MAX_TRACES, options?.maxBufferedTraces ?? DEFAULT_MAX_BUFFERED_TRACES);
+        this.maxSpansPerTrace = parseEnvInt(process.env.A365_PER_REQUEST_MAX_SPANS_PER_TRACE, options?.maxSpansPerTrace ?? DEFAULT_MAX_SPANS_PER_TRACE);
+        this.maxConcurrentExports = parseEnvInt(process.env.A365_PER_REQUEST_MAX_CONCURRENT_EXPORTS, options?.maxConcurrentExports ?? DEFAULT_MAX_CONCURRENT_EXPORTS);
+        this.flushGraceMs = parseEnvInt(process.env.A365_PER_REQUEST_FLUSH_GRACE_MS, options?.flushGraceMs ?? DEFAULT_FLUSH_GRACE_MS);
+        this.maxTraceAgeMs = parseEnvInt(process.env.A365_PER_REQUEST_MAX_TRACE_AGE_MS, options?.maxTraceAgeMs ?? DEFAULT_MAX_TRACE_AGE_MS);
+    }
+    onStart(span, ctx) {
+        const traceId = span.spanContext().traceId;
+        let buf = this.traces.get(traceId);
+        if (!buf) {
+            if (this.traces.size >= this.maxBufferedTraces) {
+                logger.warn(`[PerRequestSpanProcessor] Dropping new trace due to maxBufferedTraces=${this.maxBufferedTraces} traceId=${traceId}`);
+                return;
+            }
+            buf = {
+                spans: [],
+                openCount: 0,
+                rootEnded: false,
+                rootCtx: undefined,
+                startedAtMs: Date.now(),
+                droppedSpans: 0,
+            };
+            this.traces.set(traceId, buf);
+            this.ensureSweepTimer();
+            logger.debug(`[PerRequestSpanProcessor] Trace started traceId=${traceId} maxTraceAgeMs=${this.maxTraceAgeMs}`);
+        }
+        buf.openCount += 1;
+        const root = isRootSpanFromContext(ctx);
+        logger.debug(`[PerRequestSpanProcessor] Span start traceId=${traceId} spanId=${span.spanContext().spanId}` +
+            ` root=${root} openCount=${buf.openCount}`);
+        // Capture a context to export under.
+        if (root) {
+            buf.rootCtx = ctx;
+        }
+        else {
+            buf.rootCtx ??= ctx;
+        }
+    }
+    onEnd(span) {
+        const traceId = span.spanContext().traceId;
+        const buf = this.traces.get(traceId);
+        if (!buf)
+            return;
+        if (buf.spans.length >= this.maxSpansPerTrace) {
+            buf.droppedSpans += 1;
+            if (buf.droppedSpans === 1 || buf.droppedSpans % 100 === 0) {
+                logger.warn(`[PerRequestSpanProcessor] Dropping ended span due to maxSpansPerTrace=${this.maxSpansPerTrace} ` +
+                    `traceId=${traceId} droppedSpans=${buf.droppedSpans}`);
+            }
+        }
+        else {
+            buf.spans.push(span);
+        }
+        buf.openCount -= 1;
+        if (buf.openCount < 0) {
+            logger.warn(`[PerRequestSpanProcessor] openCount underflow traceId=${traceId} spanId=${span.spanContext().spanId} resettingToZero`);
+            buf.openCount = 0;
+        }
+        logger.debug(`[PerRequestSpanProcessor] Span end name=${span.name} traceId=${traceId} spanId=${span.spanContext().spanId}` +
+            ` root=${isRootSpan(span)} openCount=${buf.openCount} rootEnded=${buf.rootEnded}`);
+        if (isRootSpan(span)) {
+            buf.rootEnded = true;
+            buf.rootEndedAtMs = Date.now();
+            if (buf.openCount === 0) {
+                this.flushTrace(traceId, "trace_completed");
+            }
+        }
+        else if (buf.rootEnded && buf.openCount === 0) {
+            this.flushTrace(traceId, "trace_completed");
+        }
+    }
+    async forceFlush() {
+        await Promise.all([...this.traces.keys()].map((id) => this.flushTrace(id, "force_flush")));
+    }
+    async shutdown() {
+        await this.forceFlush();
+        this.stopSweepTimerIfIdle();
+        await this.exporter.shutdown?.();
+    }
+    ensureSweepTimer() {
+        if (this.sweepTimer)
+            return;
+        const intervalMs = Math.max(10, Math.min(this.flushGraceMs, 250));
+        this.sweepTimer = setInterval(() => {
+            void this.sweep();
+        }, intervalMs);
+        if (typeof this.sweepTimer === "object" && "unref" in this.sweepTimer) {
+            this.sweepTimer.unref();
+        }
+    }
+    stopSweepTimerIfIdle() {
+        if (this.traces.size !== 0)
+            return;
+        if (!this.sweepTimer)
+            return;
+        clearInterval(this.sweepTimer);
+        this.sweepTimer = undefined;
+    }
+    async sweep() {
+        if (this.isSweeping)
+            return;
+        this.isSweeping = true;
+        try {
+            if (this.traces.size === 0) {
+                this.stopSweepTimerIfIdle();
+                return;
+            }
+            const now = Date.now();
+            const toFlush = [];
+            for (const [traceId, trace] of this.traces.entries()) {
+                // 1) Max age safety flush
+                if (now - trace.startedAtMs >= this.maxTraceAgeMs) {
+                    toFlush.push({ traceId, reason: "max_trace_age" });
+                    continue;
+                }
+                // 2) Root ended grace window flush
+                if (trace.rootEnded && trace.openCount > 0 && trace.rootEndedAtMs) {
+                    if (now - trace.rootEndedAtMs >= this.flushGraceMs) {
+                        toFlush.push({ traceId, reason: "root_ended_grace" });
+                    }
+                }
+            }
+            await Promise.all(toFlush.map((x) => this.flushTrace(x.traceId, x.reason)));
+            this.stopSweepTimerIfIdle();
+        }
+        finally {
+            this.isSweeping = false;
+        }
+    }
+    async flushTrace(traceId, reason) {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return;
+        this.traces.delete(traceId);
+        this.stopSweepTimerIfIdle();
+        const spans = trace.spans;
+        if (spans.length === 0)
+            return;
+        logger.debug(`[PerRequestSpanProcessor] Flushing trace traceId=${traceId} reason=${reason} spans=${spans.length} rootEnded=${trace.rootEnded}`);
+        if (!trace.rootCtx) {
+            logger.error(`[PerRequestSpanProcessor] Missing rootCtx for trace ${traceId}, cannot export spans`);
+            return;
+        }
+        await this.acquireExportSlot();
+        try {
+            await new Promise((resolve) => {
+                try {
+                    context.with(trace.rootCtx, () => {
+                        try {
+                            this.exporter.export(spans, (result) => {
+                                if (result.code !== 0) {
+                                    logger.error(`[PerRequestSpanProcessor] Export failed traceId=${traceId} reason=${reason} code=${result.code}`, result.error);
+                                }
+                                else {
+                                    logger.debug(`[PerRequestSpanProcessor] Export succeeded traceId=${traceId} reason=${reason} spans=${spans.length}`);
+                                }
+                                resolve();
+                            });
+                        }
+                        catch (err) {
+                            logger.error(`[PerRequestSpanProcessor] Export threw traceId=${traceId} reason=${reason} spans=${spans.length}`, err);
+                            resolve();
+                        }
+                    });
+                }
+                catch (err) {
+                    logger.error(`[PerRequestSpanProcessor] context.with threw traceId=${traceId} reason=${reason}`, err);
+                    resolve();
+                }
+            });
+        }
+        finally {
+            this.releaseExportSlot();
+        }
+    }
+    async acquireExportSlot() {
+        if (this.maxConcurrentExports <= 0)
+            return;
+        if (this.inFlightExports < this.maxConcurrentExports) {
+            this.inFlightExports += 1;
+            return;
+        }
+        await new Promise((resolve) => {
+            this.exportWaiters.push(() => {
+                this.inFlightExports += 1;
+                resolve();
+            });
+        });
+    }
+    releaseExportSlot() {
+        if (this.maxConcurrentExports <= 0)
+            return;
+        this.inFlightExports = Math.max(0, this.inFlightExports - 1);
+        const next = this.exportWaiters.shift();
+        if (next)
+            next();
+    }
+}
+//# sourceMappingURL=PerRequestSpanProcessor.js.map

package/dist/esm/a365/processors/PerRequestSpanProcessor.js.map

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

package/dist/esm/a365/processors/index.d.ts

@@ -0,0 +1,5 @@
+export { A365SpanProcessor } from "./A365SpanProcessor.js";
+export { GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES } from "./util.js";
+export { PerRequestSpanProcessor } from "./PerRequestSpanProcessor.js";
+export type { PerRequestSpanProcessorOptions } from "./PerRequestSpanProcessor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/a365/processors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a365/processors/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/esm/a365/processors/index.js

@@ -0,0 +1,6 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { A365SpanProcessor } from "./A365SpanProcessor.js";
+export { GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES } from "./util.js";
+export { PerRequestSpanProcessor } from "./PerRequestSpanProcessor.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/a365/processors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/a365/processors/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/esm/a365/processors/util.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generic / common tracing attributes applied to all spans.
+ */
+export declare const GENERIC_ATTRIBUTES: readonly string[];
+/**
+ * Invoke Agent-specific attributes.
+ * These are only applied to spans whose operation is `invoke_agent`.
+ */
+export declare const INVOKE_AGENT_ATTRIBUTES: readonly string[];
+//# sourceMappingURL=util.d.ts.map

package/dist/esm/a365/processors/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../src/a365/processors/util.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EA0B/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EASpD,CAAC"}

package/dist/esm/a365/processors/util.js

@@ -0,0 +1,53 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Attribute key sets used by the SpanProcessor to copy baggage entries to span attributes.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/processors/util.ts
+ */
+import { OpenTelemetryConstants as consts } from "../constants.js";
+/**
+ * Generic / common tracing attributes applied to all spans.
+ */
+export const GENERIC_ATTRIBUTES = [
+    consts.TENANT_ID_KEY,
+    consts.CUSTOM_PARENT_SPAN_ID_KEY,
+    consts.CUSTOM_SPAN_NAME_KEY,
+    consts.SESSION_ID_KEY,
+    consts.GEN_AI_CONVERSATION_ID_KEY,
+    consts.GEN_AI_CONVERSATION_ITEM_LINK_KEY,
+    consts.GEN_AI_OPERATION_NAME_KEY,
+    consts.GEN_AI_AGENT_ID_KEY,
+    consts.GEN_AI_AGENT_NAME_KEY,
+    consts.GEN_AI_AGENT_DESCRIPTION_KEY,
+    consts.SESSION_DESCRIPTION_KEY,
+    consts.GEN_AI_AGENT_EMAIL_KEY,
+    consts.GEN_AI_AGENT_AUID_KEY,
+    consts.GEN_AI_AGENT_PLATFORM_ID_KEY,
+    consts.GEN_AI_AGENT_BLUEPRINT_ID_KEY,
+    consts.GEN_AI_AGENT_VERSION_KEY,
+    consts.SERVICE_NAME_KEY,
+    // Caller / Invoker attributes
+    consts.USER_ID_KEY,
+    consts.USER_NAME_KEY,
+    consts.USER_EMAIL_KEY,
+    consts.GEN_AI_CALLER_CLIENT_IP_KEY,
+    // Channel attributes
+    consts.CHANNEL_NAME_KEY,
+    consts.CHANNEL_LINK_KEY,
+];
+/**
+ * Invoke Agent-specific attributes.
+ * These are only applied to spans whose operation is `invoke_agent`.
+ */
+export const INVOKE_AGENT_ATTRIBUTES = [
+    // Caller Agent (A2A) attributes
+    consts.GEN_AI_CALLER_AGENT_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_NAME_KEY,
+    consts.GEN_AI_CALLER_AGENT_USER_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_EMAIL_KEY,
+    consts.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_VERSION_KEY,
+];
+//# sourceMappingURL=util.js.map

package/dist/esm/a365/processors/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../src/a365/processors/util.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,MAAM,CAAC,aAAa;IACpB,MAAM,CAAC,yBAAyB;IAChC,MAAM,CAAC,oBAAoB;IAC3B,MAAM,CAAC,cAAc;IACrB,MAAM,CAAC,0BAA0B;IACjC,MAAM,CAAC,iCAAiC;IACxC,MAAM,CAAC,yBAAyB;IAChC,MAAM,CAAC,mBAAmB;IAC1B,MAAM,CAAC,qBAAqB;IAC5B,MAAM,CAAC,4BAA4B;IACnC,MAAM,CAAC,uBAAuB;IAC9B,MAAM,CAAC,sBAAsB;IAC7B,MAAM,CAAC,qBAAqB;IAC5B,MAAM,CAAC,4BAA4B;IACnC,MAAM,CAAC,6BAA6B;IACpC,MAAM,CAAC,wBAAwB;IAC/B,MAAM,CAAC,gBAAgB;IACvB,8BAA8B;IAC9B,MAAM,CAAC,WAAW;IAClB,MAAM,CAAC,aAAa;IACpB,MAAM,CAAC,cAAc;IACrB,MAAM,CAAC,2BAA2B;IAClC,qBAAqB;IACrB,MAAM,CAAC,gBAAgB;IACvB,MAAM,CAAC,gBAAgB;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,gCAAgC;IAChC,MAAM,CAAC,0BAA0B;IACjC,MAAM,CAAC,4BAA4B;IACnC,MAAM,CAAC,+BAA+B;IACtC,MAAM,CAAC,6BAA6B;IACpC,MAAM,CAAC,sCAAsC;IAC7C,MAAM,CAAC,mCAAmC;IAC1C,MAAM,CAAC,+BAA+B;CACvC,CAAC"}

package/dist/esm/a365/scopes/ExecuteToolScope.d.ts

@@ -0,0 +1,24 @@
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import type { ToolCallDetails, AgentDetails, UserDetails, Request, SpanDetails } from "../contracts.js";
+/**
+ * Provides OpenTelemetry tracing scope for AI tool execution operations.
+ */
+export declare class ExecuteToolScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for tool execution tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param details The tool call details (name, type, args, call id, etc.).
+     * @param agentDetails The agent executing the tool. `tenantId` is required.
+     * @param userDetails Optional human caller identity.
+     * @param spanDetails Optional span configuration. Defaults to SpanKind.INTERNAL.
+     */
+    static start(request: Request, details: ToolCallDetails, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): ExecuteToolScope;
+    private constructor();
+    /**
+     * Records response information for telemetry tracking.
+     * Objects are serialized to JSON automatically.
+     */
+    recordResponse(response: Record<string, unknown> | string): void;
+}
+//# sourceMappingURL=ExecuteToolScope.d.ts.map

package/dist/esm/a365/scopes/ExecuteToolScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteToolScope.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;OAQG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB;IAInB,OAAO;IA+CP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;CAMxE"}

package/dist/esm/a365/scopes/ExecuteToolScope.js

@@ -0,0 +1,56 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { SpanKind } from "@opentelemetry/api";
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import { OpenTelemetryConstants } from "../constants.js";
+import { safeSerializeToJson } from "../message-utils.js";
+/**
+ * Provides OpenTelemetry tracing scope for AI tool execution operations.
+ */
+export class ExecuteToolScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for tool execution tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param details The tool call details (name, type, args, call id, etc.).
+     * @param agentDetails The agent executing the tool. `tenantId` is required.
+     * @param userDetails Optional human caller identity.
+     * @param spanDetails Optional span configuration. Defaults to SpanKind.INTERNAL.
+     */
+    static start(request, details, agentDetails, userDetails, spanDetails) {
+        return new ExecuteToolScope(request, details, agentDetails, userDetails, spanDetails);
+    }
+    constructor(request, details, agentDetails, userDetails, spanDetails) {
+        if (!agentDetails.tenantId) {
+            throw new Error("ExecuteToolScope: tenantId is required on agentDetails");
+        }
+        const resolvedSpanDetails = {
+            spanKind: SpanKind.INTERNAL,
+            ...spanDetails,
+        };
+        super(OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME, `${OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME} ${details.toolName}`, agentDetails, resolvedSpanDetails, userDetails);
+        const { toolName, arguments: args, toolCallId, description, toolType, endpoint } = details;
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_NAME_KEY, toolName);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY, args != null ? safeSerializeToJson(args, "arguments") : undefined);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_TYPE_KEY, toolType);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_CALL_ID_KEY, toolCallId);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_DESCRIPTION_KEY, description);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, request.conversationId);
+        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_NAME_KEY, request.channel?.name);
+        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_LINK_KEY, request.channel?.description);
+        if (endpoint) {
+            this.setTagMaybe(OpenTelemetryConstants.SERVER_ADDRESS_KEY, endpoint.host);
+            if (endpoint.port && endpoint.port !== 443) {
+                this.setTagMaybe(OpenTelemetryConstants.SERVER_PORT_KEY, endpoint.port);
+            }
+        }
+    }
+    /**
+     * Records response information for telemetry tracking.
+     * Objects are serialized to JSON automatically.
+     */
+    recordResponse(response) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_CALL_RESULT_KEY, safeSerializeToJson(response, "result"));
+    }
+}
+//# sourceMappingURL=ExecuteToolScope.js.map

package/dist/esm/a365/scopes/ExecuteToolScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteToolScope.js","sourceRoot":"","sources":["../../../../src/a365/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAS1D;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;OAQG;IACI,MAAM,CAAC,KAAK,CACjB,OAAgB,EAChB,OAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACxF,CAAC;IAED,YACE,OAAgB,EAChB,OAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,mBAAmB,GAAgB;YACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,WAAW;SACf,CAAC;QAEF,KAAK,CACH,sBAAsB,CAAC,2BAA2B,EAClD,GAAG,sBAAsB,CAAC,2BAA2B,IAAI,OAAO,CAAC,QAAQ,EAAE,EAC3E,YAAY,EACZ,mBAAmB,EACnB,WAAW,CACZ,CAAC;QAEF,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAE3F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,oBAAoB,EAC3C,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC;QAElF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExF,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3E,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,cAAc,CAAC,QAA0C;QAC9D,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,2BAA2B,EAClD,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/a365/scopes/InferenceScope.d.ts

@@ -0,0 +1,29 @@
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import type { InferenceDetails, AgentDetails, UserDetails, Request, SpanDetails, InputMessagesParam, OutputMessagesParam } from "../contracts.js";
+/**
+ * Provides OpenTelemetry tracing scope for generative AI inference operations.
+ */
+export declare class InferenceScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for inference tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param details The inference call details (model, provider, tokens, etc.).
+     * @param agentDetails The agent performing the inference. `tenantId` is required.
+     * @param userDetails Optional human caller identity.
+     * @param spanDetails Optional span configuration. `spanKind` is always CLIENT.
+     */
+    static start(request: Request, details: InferenceDetails, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): InferenceScope;
+    private constructor();
+    /** Records the number of input tokens. */
+    recordInputTokens(inputTokens: number): void;
+    /** Records the number of output tokens. */
+    recordOutputTokens(outputTokens: number): void;
+    /** Records the finish reasons. */
+    recordFinishReasons(finishReasons: string[]): void;
+    /** Records the input messages for telemetry tracking. */
+    recordInputMessages(messages: InputMessagesParam): void;
+    /** Records the output messages for telemetry tracking. */
+    recordOutputMessages(messages: OutputMessagesParam): void;
+}
+//# sourceMappingURL=InferenceScope.d.ts.map

package/dist/esm/a365/scopes/InferenceScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceScope.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/InferenceScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD;;;;;;;;OAQG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc;IAIjB,OAAO;IAkDP,0CAA0C;IACnC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAInD,2CAA2C;IACpC,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIrD,kCAAkC;IAC3B,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;IAMzD,yDAAyD;IACzC,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIvE,0DAA0D;IAC1C,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;CAG1E"}

package/dist/esm/a365/scopes/InferenceScope.js

@@ -0,0 +1,71 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { SpanKind } from "@opentelemetry/api";
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import { OpenTelemetryConstants } from "../constants.js";
+/**
+ * Provides OpenTelemetry tracing scope for generative AI inference operations.
+ */
+export class InferenceScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for inference tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param details The inference call details (model, provider, tokens, etc.).
+     * @param agentDetails The agent performing the inference. `tenantId` is required.
+     * @param userDetails Optional human caller identity.
+     * @param spanDetails Optional span configuration. `spanKind` is always CLIENT.
+     */
+    static start(request, details, agentDetails, userDetails, spanDetails) {
+        return new InferenceScope(request, details, agentDetails, userDetails, spanDetails);
+    }
+    constructor(request, details, agentDetails, userDetails, spanDetails) {
+        if (!agentDetails.tenantId) {
+            throw new Error("InferenceScope: tenantId is required on agentDetails");
+        }
+        // spanKind for InferenceScope is always CLIENT
+        const resolvedSpanDetails = { ...spanDetails, spanKind: SpanKind.CLIENT };
+        super(details.operationName.toString(), `${details.operationName} ${details.model}`, agentDetails, resolvedSpanDetails, userDetails);
+        // Core inference information
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY, details.model);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_PROVIDER_NAME_KEY, details.providerName);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY, details.inputTokens);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY, details.outputTokens);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY, details.finishReasons);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_THOUGHT_PROCESS_KEY, details.thoughtProcess);
+        // Conversation and channel
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, request.conversationId);
+        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_NAME_KEY, request.channel?.name);
+        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_LINK_KEY, request.channel?.description);
+        // Endpoint
+        if (details.endpoint) {
+            this.setTagMaybe(OpenTelemetryConstants.SERVER_ADDRESS_KEY, details.endpoint.host);
+            if (details.endpoint.port && details.endpoint.port !== 443) {
+                this.setTagMaybe(OpenTelemetryConstants.SERVER_PORT_KEY, details.endpoint.port);
+            }
+        }
+    }
+    /** Records the number of input tokens. */
+    recordInputTokens(inputTokens) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY, inputTokens);
+    }
+    /** Records the number of output tokens. */
+    recordOutputTokens(outputTokens) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY, outputTokens);
+    }
+    /** Records the finish reasons. */
+    recordFinishReasons(finishReasons) {
+        if (finishReasons && finishReasons.length > 0) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY, finishReasons);
+        }
+    }
+    /** Records the input messages for telemetry tracking. */
+    recordInputMessages(messages) {
+        super.recordInputMessages(messages);
+    }
+    /** Records the output messages for telemetry tracking. */
+    recordOutputMessages(messages) {
+        super.recordOutputMessages(messages);
+    }
+}
+//# sourceMappingURL=InferenceScope.js.map

package/dist/esm/a365/scopes/InferenceScope.js.map

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

package/dist/esm/a365/scopes/InvokeAgentScope.d.ts

@@ -0,0 +1,25 @@
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import type { InvokeAgentScopeDetails, CallerDetails, Request, SpanDetails, AgentDetails, InputMessagesParam, OutputMessagesParam } from "../contracts.js";
+/**
+ * Provides OpenTelemetry tracing scope for AI agent invocation operations.
+ */
+export declare class InvokeAgentScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for agent invocation tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param invokeScopeDetails Scope-level details (endpoint).
+     * @param agentDetails The agent identity. `tenantId` is required.
+     * @param callerDetails Optional caller information (human, agent, or both for A2A).
+     * @param spanDetails Optional span configuration.
+     */
+    static start(request: Request, invokeScopeDetails: InvokeAgentScopeDetails, agentDetails: AgentDetails, callerDetails?: CallerDetails, spanDetails?: SpanDetails): InvokeAgentScope;
+    private constructor();
+    /** Records response information for telemetry tracking. */
+    recordResponse(response: string): void;
+    /** Records the input messages for telemetry tracking. */
+    recordInputMessages(messages: InputMessagesParam): void;
+    /** Records the output messages for telemetry tracking. */
+    recordOutputMessages(messages: OutputMessagesParam): void;
+}
+//# sourceMappingURL=InvokeAgentScope.d.ts.map

package/dist/esm/a365/scopes/InvokeAgentScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvokeAgentScope.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/InvokeAgentScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,OAAO,EACP,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;OAQG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,uBAAuB,EAC3C,YAAY,EAAE,YAAY,EAC1B,aAAa,CAAC,EAAE,aAAa,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB;IAUnB,OAAO;IAkFP,2DAA2D;IACpD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7C,yDAAyD;IACzC,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIvE,0DAA0D;IAC1C,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;CAG1E"}