@microsoft/agents-a365-observability 0.1.0-preview.30

package/dist/cjs/tracing/processors/SpanProcessor.js

@@ -0,0 +1,98 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanProcessor = void 0;
+const api_1 = require("@opentelemetry/api");
+const constants_1 = require("../constants");
+const util_1 = require("./util");
+/**
+ * Span processor that propagates baggage key/value pairs to span attributes.
+ *
+ * This processor copies baggage entries onto spans based on the operation type.
+ * For invoke_agent operations, it applies both generic and invoke-agent-specific attributes.
+ * For other operations, it applies only generic attributes.
+ */
+class SpanProcessor {
+    /**
+     * Called when a span is started.
+     * Copies relevant baggage entries to span attributes.
+     */
+    onStart(span, parentContext) {
+        const ctx = parentContext;
+        if (!ctx) {
+            return;
+        }
+        // Get existing span attributes
+        const existingAttrs = new Set();
+        try {
+            const spanRecord = span;
+            if (spanRecord.attributes) {
+                Object.keys(spanRecord.attributes).forEach(key => existingAttrs.add(key));
+            }
+        }
+        catch {
+            // Ignore errors accessing span attributes
+        }
+        // Get all baggage entries
+        const baggage = api_1.propagation.getBaggage(ctx);
+        if (!baggage) {
+            return;
+        }
+        const baggageMap = new Map();
+        baggage.getAllEntries().forEach(([key, entry]) => {
+            if (entry.value) {
+                baggageMap.set(key, entry.value);
+            }
+        });
+        // Determine if this is an invoke_agent operation
+        const operationName = baggageMap.get(constants_1.OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY) ||
+            span.attributes?.[constants_1.OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY];
+        const spanName = span.name || '';
+        const isInvokeAgent = operationName === constants_1.OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME ||
+            spanName.startsWith(constants_1.OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME);
+        // Build target key set
+        const targetKeys = new Set(util_1.GENERIC_ATTRIBUTES);
+        if (isInvokeAgent) {
+            util_1.INVOKE_AGENT_ATTRIBUTES.forEach(key => targetKeys.add(key));
+        }
+        // Copy baggage to span attributes
+        for (const key of targetKeys) {
+            // Skip if attribute already exists
+            if (existingAttrs.has(key)) {
+                continue;
+            }
+            const value = baggageMap.get(key);
+            if (!value) {
+                continue;
+            }
+            try {
+                span.setAttribute(key, value);
+            }
+            catch {
+                // Ignore errors setting attributes
+            }
+        }
+    }
+    /**
+     * Called when a span is ended.
+     */
+    onEnd(_span) {
+        // No-op for this processor
+    }
+    /**
+     * Shutdown the processor.
+     */
+    async shutdown() {
+        // No-op for this processor
+    }
+    /**
+     * Force flush the processor.
+     */
+    async forceFlush() {
+        // No-op for this processor
+    }
+}
+exports.SpanProcessor = SpanProcessor;
+//# sourceMappingURL=SpanProcessor.js.map

package/dist/cjs/tracing/processors/SpanProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanProcessor.js","sourceRoot":"","sources":["../../../../src/tracing/processors/SpanProcessor.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF,4CAAgE;AAGhE,4CAAsD;AACtD,iCAAqE;AAErE;;;;;;GAMG;AACH,MAAa,aAAa;IACxB;;;OAGG;IACH,OAAO,CAAC,IAAU,EAAE,aAAuB;QACzC,MAAM,GAAG,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAW,CAAC;YAC/B,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;QAED,0BAA0B;QAC1B,MAAM,OAAO,GAAG,iBAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC/C,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,aAAa,GACjB,UAAU,CAAC,GAAG,CAAC,kCAAsB,CAAC,yBAAyB,CAAC;YAC/D,IAAY,CAAC,UAAU,EAAE,CAAC,kCAAsB,CAAC,yBAAyB,CAAC,CAAC;QAE/E,MAAM,QAAQ,GAAI,IAAY,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,aAAa,GACjB,aAAa,KAAK,kCAAsB,CAAC,2BAA2B;YACpE,QAAQ,CAAC,UAAU,CAAC,kCAAsB,CAAC,2BAA2B,CAAC,CAAC;QAE1E,uBAAuB;QACvB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,yBAAkB,CAAC,CAAC;QACvD,IAAI,aAAa,EAAE,CAAC;YAClB,8BAAuB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,mCAAmC;YACnC,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAmB;QACvB,2BAA2B;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,2BAA2B;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,2BAA2B;IAC7B,CAAC;CACF;AA3FD,sCA2FC"}

package/dist/cjs/tracing/processors/util.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generic / common tracing attributes applied to all spans
+ */
+export declare const GENERIC_ATTRIBUTES: readonly string[];
+/**
+ * Invoke Agent-specific attributes
+ */
+export declare const INVOKE_AGENT_ATTRIBUTES: readonly string[];
+//# sourceMappingURL=util.d.ts.map

package/dist/cjs/tracing/processors/util.d.ts.map

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

package/dist/cjs/tracing/processors/util.js

@@ -0,0 +1,50 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOKE_AGENT_ATTRIBUTES = exports.GENERIC_ATTRIBUTES = void 0;
+const constants_1 = require("../constants");
+/**
+ * Generic / common tracing attributes applied to all spans
+ */
+exports.GENERIC_ATTRIBUTES = [
+    constants_1.OpenTelemetryConstants.TENANT_ID_KEY,
+    constants_1.OpenTelemetryConstants.CUSTOM_PARENT_SPAN_ID_KEY,
+    constants_1.OpenTelemetryConstants.CUSTOM_SPAN_NAME_KEY,
+    constants_1.OpenTelemetryConstants.CORRELATION_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_USER_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_UPN_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY,
+];
+/**
+ * Invoke Agent-specific attributes
+ */
+exports.INVOKE_AGENT_ATTRIBUTES = [
+    // Caller / Invoker attributes
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_NAME_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_UPN_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_USER_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_TENANT_ID_KEY,
+    // Caller Agent (A2A) attributes
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_NAME_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_USER_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_UPN_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_TENANT_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY,
+    // Execution context
+    constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_ID_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_NAME_KEY,
+    constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY,
+];
+//# sourceMappingURL=util.js.map

package/dist/cjs/tracing/processors/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../src/tracing/processors/util.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF,4CAAgE;AAEhE;;GAEG;AACU,QAAA,kBAAkB,GAAsB;IACnD,kCAAM,CAAC,aAAa;IACpB,kCAAM,CAAC,yBAAyB;IAChC,kCAAM,CAAC,oBAAoB;IAC3B,kCAAM,CAAC,kBAAkB;IACzB,kCAAM,CAAC,0BAA0B;IACjC,kCAAM,CAAC,iCAAiC;IACxC,kCAAM,CAAC,yBAAyB;IAChC,kCAAM,CAAC,mBAAmB;IAC1B,kCAAM,CAAC,qBAAqB;IAC5B,kCAAM,CAAC,4BAA4B;IACnC,kCAAM,CAAC,wBAAwB;IAC/B,kCAAM,CAAC,oBAAoB;IAC3B,kCAAM,CAAC,6BAA6B;IACpC,kCAAM,CAAC,qBAAqB;CAC7B,CAAC;AAEF;;GAEG;AACU,QAAA,uBAAuB,GAAsB;IACxD,8BAA8B;IAC9B,kCAAM,CAAC,oBAAoB;IAC3B,kCAAM,CAAC,sBAAsB;IAC7B,kCAAM,CAAC,qBAAqB;IAC5B,kCAAM,CAAC,yBAAyB;IAChC,kCAAM,CAAC,2BAA2B;IAClC,gCAAgC;IAChC,kCAAM,CAAC,0BAA0B;IACjC,kCAAM,CAAC,4BAA4B;IACnC,kCAAM,CAAC,+BAA+B;IACtC,kCAAM,CAAC,2BAA2B;IAClC,kCAAM,CAAC,iCAAiC;IACxC,kCAAM,CAAC,sCAAsC;IAC7C,oBAAoB;IACpB,kCAAM,CAAC,yBAAyB;IAChC,kCAAM,CAAC,8BAA8B;IACrC,kCAAM,CAAC,gCAAgC;IACvC,kCAAM,CAAC,uCAAuC;CAC/C,CAAC"}

package/dist/cjs/tracing/scopes/ExecuteToolScope.d.ts

@@ -0,0 +1,22 @@
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { ToolCallDetails, AgentDetails, TenantDetails } from '../contracts';
+/**
+ * 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 details The tool call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new ExecuteToolScope instance.
+     */
+    static start(details: ToolCallDetails, agentDetails: AgentDetails, tenantDetails: TenantDetails): ExecuteToolScope;
+    private constructor();
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The tool execution response
+     */
+    recordResponse(response: string): void;
+}
+//# sourceMappingURL=ExecuteToolScope.d.ts.map

package/dist/cjs/tracing/scopes/ExecuteToolScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteToolScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG5E;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;OAMG;WACW,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,GAAG,gBAAgB;IAIzH,OAAO;IA6BP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG9C"}

package/dist/cjs/tracing/scopes/ExecuteToolScope.js

@@ -0,0 +1,51 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecuteToolScope = void 0;
+const api_1 = require("@opentelemetry/api");
+const OpenTelemetryScope_1 = require("./OpenTelemetryScope");
+const constants_1 = require("../constants");
+/**
+ * Provides OpenTelemetry tracing scope for AI tool execution operations.
+ */
+class ExecuteToolScope extends OpenTelemetryScope_1.OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for tool execution tracing.
+     * @param details The tool call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new ExecuteToolScope instance.
+     */
+    static start(details, agentDetails, tenantDetails) {
+        return new ExecuteToolScope(details, agentDetails, tenantDetails);
+    }
+    constructor(details, agentDetails, tenantDetails) {
+        super(api_1.SpanKind.INTERNAL, constants_1.OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME, `${constants_1.OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME} ${details.toolName}`, agentDetails, tenantDetails);
+        // Destructure the details object to match C# pattern
+        const { toolName, arguments: args, toolCallId, description, toolType, endpoint } = details;
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_TOOL_NAME_KEY, toolName);
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY, args);
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_TOOL_TYPE_KEY, toolType);
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_TOOL_CALL_ID_KEY, toolCallId);
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_TOOL_DESCRIPTION_KEY, description);
+        // Set endpoint information if provided
+        if (endpoint) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.SERVER_ADDRESS_KEY, endpoint.host);
+            // Only record port if it is different from 443 (default HTTPS port)
+            if (endpoint.port && endpoint.port !== 443) {
+                this.setTagMaybe(constants_1.OpenTelemetryConstants.SERVER_PORT_KEY, endpoint.port);
+            }
+        }
+    }
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The tool execution response
+     */
+    recordResponse(response) {
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_EVENT_CONTENT, response);
+    }
+}
+exports.ExecuteToolScope = ExecuteToolScope;
+//# sourceMappingURL=ExecuteToolScope.js.map

package/dist/cjs/tracing/scopes/ExecuteToolScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteToolScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF,4CAA8C;AAC9C,6DAA0D;AAE1D,4CAAsD;AAEtD;;GAEG;AACH,MAAa,gBAAiB,SAAQ,uCAAkB;IACtD;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,OAAwB,EAAE,YAA0B,EAAE,aAA4B;QACpG,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC;IAED,YAAoB,OAAwB,EAAE,YAA0B,EAAE,aAA4B;QACpG,KAAK,CACH,cAAQ,CAAC,QAAQ,EACjB,kCAAsB,CAAC,2BAA2B,EAClD,GAAG,kCAAsB,CAAC,2BAA2B,IAAI,OAAO,CAAC,QAAQ,EAAE,EAC3E,YAAY,EACZ,aAAa,CACd,CAAC;QAEF,qDAAqD;QACrD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAE3F,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC;QAElF,uCAAuC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAE3E,oEAAoE;YACpE,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,cAAc,CAAC,QAAgB;QACpC,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC1E,CAAC;CACF;AAhDD,4CAgDC"}

package/dist/cjs/tracing/scopes/InferenceScope.d.ts

@@ -0,0 +1,47 @@
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { InferenceDetails, AgentDetails, TenantDetails } from '../contracts';
+/**
+ * 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 details The inference call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new InferenceScope instance
+     */
+    static start(details: InferenceDetails, agentDetails: AgentDetails, tenantDetails: TenantDetails): InferenceScope;
+    private constructor();
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages: string[]): void;
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages: string[]): void;
+    /**
+     * Records the number of input tokens for telemetry tracking.
+     * @param inputTokens Number of input tokens
+     */
+    recordInputTokens(inputTokens: number): void;
+    /**
+     * Records the number of output tokens for telemetry tracking.
+     * @param outputTokens Number of output tokens
+     */
+    recordOutputTokens(outputTokens: number): void;
+    /**
+     * Records the response id for telemetry tracking.
+     * @param responseId The response ID
+     */
+    recordResponseId(responseId: string): void;
+    /**
+     * Records the finish reasons for telemetry tracking.
+     * @param finishReasons Array of finish reasons
+     */
+    recordFinishReasons(finishReasons: string[]): void;
+}
+//# sourceMappingURL=InferenceScope.d.ts.map

package/dist/cjs/tracing/scopes/InferenceScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/InferenceScope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD;;;;;;OAMG;WACW,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,GAAG,cAAc;IAIxH,OAAO;IAmBP;;;OAGG;IACI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIrD;;;OAGG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAInD;;;OAGG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIrD;;;OAGG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMjD;;;OAGG;IACI,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;CAM1D"}

package/dist/cjs/tracing/scopes/InferenceScope.js

@@ -0,0 +1,83 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InferenceScope = void 0;
+const api_1 = require("@opentelemetry/api");
+const OpenTelemetryScope_1 = require("./OpenTelemetryScope");
+const constants_1 = require("../constants");
+/**
+ * Provides OpenTelemetry tracing scope for generative AI inference operations.
+ */
+class InferenceScope extends OpenTelemetryScope_1.OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for inference tracing.
+     * @param details The inference call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new InferenceScope instance
+     */
+    static start(details, agentDetails, tenantDetails) {
+        return new InferenceScope(details, agentDetails, tenantDetails);
+    }
+    constructor(details, agentDetails, tenantDetails) {
+        super(api_1.SpanKind.CLIENT, details.operationName.toString(), `${details.operationName} ${details.model}`, agentDetails, tenantDetails);
+        // Set core inference information matching C# implementation
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY, details.operationName.toString());
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY, details.model);
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_PROVIDER_NAME_KEY, details.providerName);
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY, details.inputTokens?.toString());
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY, details.outputTokens?.toString());
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY, details.finishReasons?.join(','));
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_RESPONSE_ID_KEY, details.responseId);
+    }
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages) {
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, messages.join(','));
+    }
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages) {
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, messages.join(','));
+    }
+    /**
+     * Records the number of input tokens for telemetry tracking.
+     * @param inputTokens Number of input tokens
+     */
+    recordInputTokens(inputTokens) {
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY, inputTokens.toString());
+    }
+    /**
+     * Records the number of output tokens for telemetry tracking.
+     * @param outputTokens Number of output tokens
+     */
+    recordOutputTokens(outputTokens) {
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY, outputTokens.toString());
+    }
+    /**
+     * Records the response id for telemetry tracking.
+     * @param responseId The response ID
+     */
+    recordResponseId(responseId) {
+        if (responseId && responseId.trim()) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_RESPONSE_ID_KEY, responseId);
+        }
+    }
+    /**
+     * Records the finish reasons for telemetry tracking.
+     * @param finishReasons Array of finish reasons
+     */
+    recordFinishReasons(finishReasons) {
+        if (finishReasons && finishReasons.length > 0) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY, finishReasons.join(','));
+        }
+    }
+}
+exports.InferenceScope = InferenceScope;
+//# sourceMappingURL=InferenceScope.js.map

package/dist/cjs/tracing/scopes/InferenceScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/InferenceScope.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF,4CAA8C;AAC9C,6DAA0D;AAC1D,4CAAsD;AAOtD;;GAEG;AACH,MAAa,cAAe,SAAQ,uCAAkB;IACpD;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,OAAyB,EAAE,YAA0B,EAAE,aAA4B;QACrG,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAClE,CAAC;IAED,YAAoB,OAAyB,EAAE,YAA0B,EAAE,aAA4B;QACrG,KAAK,CACH,cAAQ,CAAC,MAAM,EACf,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,EAChC,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,EAC3C,YAAY,EACZ,aAAa,CACd,CAAC;QAEF,4DAA4D;QAC5D,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,yBAAyB,EAAE,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,wBAAwB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,wBAAwB,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACxF,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,6BAA6B,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxG,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,8BAA8B,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,kCAAkC,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9G,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,sBAAsB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACtF,CAAC;IAED;;;OAGG;IACI,mBAAmB,CAAC,QAAkB;QAC3C,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,yBAAyB,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACI,oBAAoB,CAAC,QAAkB;QAC5C,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,0BAA0B,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED;;;OAGG;IACI,iBAAiB,CAAC,WAAmB;QAC1C,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,6BAA6B,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;OAGG;IACI,kBAAkB,CAAC,YAAoB;QAC5C,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,8BAA8B,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;OAGG;IACI,gBAAgB,CAAC,UAAkB;QACxC,IAAI,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,mBAAmB,CAAC,aAAuB;QAChD,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,WAAW,CAAC,kCAAsB,CAAC,kCAAkC,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;CAEF;AAnFD,wCAmFC"}

package/dist/cjs/tracing/scopes/InvokeAgentScope.d.ts

@@ -0,0 +1,33 @@
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { InvokeAgentDetails, TenantDetails, CallerDetails, EnhancedAgentDetails } from '../contracts';
+/**
+ * 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 invokeAgentDetails The details of the agent invocation including endpoint, agent information, and conversation context.
+     * @param tenantDetails The tenant details.
+     * @param callerAgentDetails The details of the caller agent.
+     * @param callerDetails The details of the non-agentic caller.
+     * @returns A new InvokeAgentScope instance.
+     */
+    static start(invokeAgentDetails: InvokeAgentDetails, tenantDetails: TenantDetails, callerAgentDetails?: EnhancedAgentDetails, callerDetails?: CallerDetails): InvokeAgentScope;
+    private constructor();
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The invocation response
+     */
+    recordResponse(response: string): void;
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages: string[]): void;
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages: string[]): void;
+}
+//# sourceMappingURL=InvokeAgentScope.d.ts.map

package/dist/cjs/tracing/scopes/InvokeAgentScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvokeAgentScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/InvokeAgentScope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IAEtD;;;;;;;OAOG;WACW,KAAK,CACjB,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,EAAE,aAAa,EAC5B,kBAAkB,CAAC,EAAE,oBAAoB,EACzC,aAAa,CAAC,EAAE,aAAa,GAC5B,gBAAgB;IAInB,OAAO;IA8DP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAMpD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAKtD"}

package/dist/cjs/tracing/scopes/InvokeAgentScope.js

@@ -0,0 +1,94 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvokeAgentScope = void 0;
+const api_1 = require("@opentelemetry/api");
+const OpenTelemetryScope_1 = require("./OpenTelemetryScope");
+const constants_1 = require("../constants");
+/**
+ * Provides OpenTelemetry tracing scope for AI agent invocation operations.
+ */
+class InvokeAgentScope extends OpenTelemetryScope_1.OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for agent invocation tracing.
+     * @param invokeAgentDetails The details of the agent invocation including endpoint, agent information, and conversation context.
+     * @param tenantDetails The tenant details.
+     * @param callerAgentDetails The details of the caller agent.
+     * @param callerDetails The details of the non-agentic caller.
+     * @returns A new InvokeAgentScope instance.
+     */
+    static start(invokeAgentDetails, tenantDetails, callerAgentDetails, callerDetails) {
+        return new InvokeAgentScope(invokeAgentDetails, tenantDetails, callerAgentDetails, callerDetails);
+    }
+    constructor(invokeAgentDetails, tenantDetails, callerAgentDetails, callerDetails) {
+        super(api_1.SpanKind.CLIENT, constants_1.OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME, invokeAgentDetails.agentName
+            ? `${constants_1.OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME} ${invokeAgentDetails.agentName}`
+            : constants_1.OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME, invokeAgentDetails, tenantDetails);
+        // Set session ID and endpoint information
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.SESSION_ID_KEY, invokeAgentDetails.sessionId);
+        if (invokeAgentDetails.endpoint) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.SERVER_ADDRESS_KEY, invokeAgentDetails.endpoint.host);
+            // Only record port if it is different from 443 (default HTTPS port)
+            if (invokeAgentDetails.endpoint.port && invokeAgentDetails.endpoint.port !== 443) {
+                this.setTagMaybe(constants_1.OpenTelemetryConstants.SERVER_PORT_KEY, invokeAgentDetails.endpoint.port);
+            }
+        }
+        // Set request-related tags
+        const requestToUse = invokeAgentDetails.request;
+        if (requestToUse) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY, requestToUse.executionType?.toString());
+            if (requestToUse.sourceMetadata) {
+                this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_ID_KEY, requestToUse.sourceMetadata.id);
+                this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_NAME_KEY, requestToUse.sourceMetadata.name);
+                this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY, requestToUse.sourceMetadata.description);
+            }
+        }
+        this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, invokeAgentDetails.conversationId);
+        // Set caller details tags
+        if (callerDetails) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_ID_KEY, callerDetails.callerId);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_UPN_KEY, callerDetails.callerUpn);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_NAME_KEY, callerDetails.callerName);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_USER_ID_KEY, callerDetails.callerUserId);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_TENANT_ID_KEY, callerDetails.tenantId);
+        }
+        // Set caller agent details tags
+        if (callerAgentDetails) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_NAME_KEY, callerAgentDetails.agentName);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_ID_KEY, callerAgentDetails.agentId);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY, callerAgentDetails.agentBlueprintId);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_USER_ID_KEY, callerAgentDetails.agentAUID);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_UPN_KEY, callerAgentDetails.agentUPN);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_TENANT_ID_KEY, callerAgentDetails.tenantId);
+        }
+    }
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The invocation response
+     */
+    recordResponse(response) {
+        this.recordOutputMessages([response]);
+    }
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages) {
+        if (InvokeAgentScope.enableTelemetry) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, messages.join(','));
+        }
+    }
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages) {
+        if (InvokeAgentScope.enableTelemetry) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, messages.join(','));
+        }
+    }
+}
+exports.InvokeAgentScope = InvokeAgentScope;
+//# sourceMappingURL=InvokeAgentScope.js.map

package/dist/cjs/tracing/scopes/InvokeAgentScope.js.map

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

package/dist/cjs/tracing/scopes/OpenTelemetryScope.d.ts

@@ -0,0 +1,57 @@
+import { SpanKind, Span } from '@opentelemetry/api';
+import { EnhancedAgentDetails, TenantDetails } from '../contracts';
+/**
+ * Base class for OpenTelemetry tracing scopes
+ */
+export declare abstract class OpenTelemetryScope implements Disposable {
+    private static readonly tracer;
+    protected readonly span: Span;
+    private readonly startTime;
+    protected static enableTelemetry: boolean;
+    private errorType?;
+    private exception?;
+    private hasEnded;
+    /**
+     * Initializes a new instance of the OpenTelemetryScope class
+     * @param kind The kind of span (CLIENT, SERVER, INTERNAL, etc.)
+     * @param operationName The name of the operation being traced
+     * @param spanName The name of the span for display purposes
+     * @param agentDetails Optional agent details
+     * @param tenantDetails Optional tenant details
+     */
+    protected constructor(kind: SpanKind, operationName: string, spanName: string, agentDetails?: EnhancedAgentDetails, tenantDetails?: TenantDetails);
+    /**
+     * Makes this span active for the duration of the async callback execution
+     */
+    withActiveSpanAsync<T>(callback: () => Promise<T>): Promise<T>;
+    /**
+     * Records an error that occurred during the operation
+     * @param error The error that occurred
+     */
+    recordError(error: Error): void;
+    /**
+     * Sets a tag on the span if telemetry is enabled
+     * @param name The tag name
+     * @param value The tag value
+     */
+    protected setTagMaybe<T extends string | number | boolean>(name: string, value: T | null | undefined): void;
+    /**
+     * Add baggage to the current context
+     * @param key The baggage key
+     * @param value The baggage value
+     */
+    protected addBaggage(key: string, value: string): void;
+    /**
+     * Finalizes the scope and records metrics
+     */
+    private end;
+    /**
+     * Disposes the scope and finalizes telemetry data collection
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Legacy dispose method for compatibility
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=OpenTelemetryScope.d.ts.map

package/dist/cjs/tracing/scopes/OpenTelemetryScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/OpenTelemetryScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,QAAQ,EAAE,IAAI,EAAuC,MAAM,oBAAoB,CAAC;AAGhG,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGnE;;GAEG;AACH,8BAAsB,kBAAmB,YAAW,UAAU;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAErF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,SAAS,CAAC,MAAM,CAAC,eAAe,UAAgC;IAEhE,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;OAOG;IACH,SAAS,aACP,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,oBAAoB,EACnC,aAAa,CAAC,EAAE,aAAa;IAoC/B;;OAEG;IACI,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKrE;;;OAGG;IACI,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAoBtC;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAM3G;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQtD;;OAEG;IACH,OAAO,CAAC,GAAG;IAsBX;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAO/B;;OAEG;IACI,OAAO,IAAI,IAAI;CAIvB"}