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

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"}

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

@@ -0,0 +1,80 @@
+// 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 AI agent invocation operations.
+ */
+export 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, invokeScopeDetails, agentDetails, callerDetails, spanDetails) {
+        return new InvokeAgentScope(request, invokeScopeDetails, agentDetails, callerDetails, spanDetails);
+    }
+    constructor(request, invokeScopeDetails, agentDetails, callerDetails, spanDetails) {
+        if (!agentDetails.tenantId) {
+            throw new Error("InvokeAgentScope: tenantId is required on agentDetails");
+        }
+        const resolvedSpanDetails = {
+            ...spanDetails,
+            spanKind: spanDetails?.spanKind ?? SpanKind.CLIENT,
+        };
+        super(OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME, agentDetails.agentName
+            ? `${OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME} ${agentDetails.agentName}`
+            : OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME, agentDetails, resolvedSpanDetails, callerDetails?.userDetails);
+        // Provider name
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_PROVIDER_NAME_KEY, agentDetails.providerName);
+        // Session ID
+        this.setTagMaybe(OpenTelemetryConstants.SESSION_ID_KEY, request.sessionId);
+        // Endpoint
+        if (invokeScopeDetails.endpoint) {
+            this.setTagMaybe(OpenTelemetryConstants.SERVER_ADDRESS_KEY, invokeScopeDetails.endpoint.host);
+            if (invokeScopeDetails.endpoint.port && invokeScopeDetails.endpoint.port !== 443) {
+                this.setTagMaybe(OpenTelemetryConstants.SERVER_PORT_KEY, invokeScopeDetails.endpoint.port);
+            }
+        }
+        // Channel
+        if (request.channel) {
+            this.setTagMaybe(OpenTelemetryConstants.CHANNEL_NAME_KEY, request.channel.name);
+            this.setTagMaybe(OpenTelemetryConstants.CHANNEL_LINK_KEY, request.channel.description);
+        }
+        // Conversation ID
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, request.conversationId);
+        // Request content as input messages
+        if (request.content != null) {
+            this.recordInputMessages(request.content);
+        }
+        // Caller agent details for A2A scenarios
+        const callerAgent = callerDetails?.callerAgentDetails;
+        if (callerAgent) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_NAME_KEY, callerAgent.agentName);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_ID_KEY, callerAgent.agentId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY, callerAgent.agentBlueprintId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_USER_ID_KEY, callerAgent.agentAUID);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_EMAIL_KEY, callerAgent.agentEmail);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY, callerAgent.platformId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_VERSION_KEY, callerAgent.agentVersion);
+        }
+    }
+    /** Records response information for telemetry tracking. */
+    recordResponse(response) {
+        this.recordOutputMessages(response);
+    }
+    /** 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=InvokeAgentScope.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * Base class for OpenTelemetry tracing scopes.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/scopes/OpenTelemetryScope.ts
+ */
+import type { Span, SpanContext, AttributeValue, TimeInput } from "@opentelemetry/api";
+import type { AgentDetails, UserDetails, SpanDetails, InputMessagesParam, OutputMessagesParam } from "../contracts.js";
+/**
+ * Base class for OpenTelemetry tracing scopes.
+ *
+ * Subclasses: `InvokeAgentScope`, `ExecuteToolScope`, `InferenceScope`, `OutputScope`.
+ */
+export declare abstract class OpenTelemetryScope {
+    /**
+     * Returns a tracer from the current global TracerProvider.
+     *
+     * This **must not** be stored in a static field because the distro's
+     * `useMicrosoftOpenTelemetry()` resets the global API state
+     * (`trace.disable()` + global-object deletion) before starting the
+     * NodeSDK. A static field would capture a `ProxyTracer` bound to the
+     * old `ProxyTracerProvider` whose delegate is never set, producing
+     * `NoopSpan` instances with zeroed trace/span IDs.
+     */
+    private static getTracer;
+    protected readonly span: Span;
+    private readonly wallClockStartMs;
+    private customStartTime?;
+    private customEndTime?;
+    private errorType?;
+    private hasEnded;
+    private readonly logger;
+    /**
+     * @param operationName The name of the operation being traced.
+     * @param spanName The display name of the span.
+     * @param agentDetails Optional agent details. Tenant ID is read from `agentDetails.tenantId`.
+     * @param spanDetails Optional span configuration including parent context, start/end times, span kind, and span links.
+     * @param userDetails Optional human caller identity details.
+     */
+    protected constructor(operationName: string, spanName: string, agentDetails?: AgentDetails, spanDetails?: SpanDetails, userDetails?: UserDetails);
+    /** Makes this span active for the duration of the async callback execution. */
+    withActiveSpanAsync<T>(callback: () => Promise<T>): Promise<T>;
+    /** Gets the span context for this scope. */
+    getSpanContext(): SpanContext;
+    /** Records an error that occurred during the operation. */
+    recordError(error: Error): void;
+    /** Records multiple attribute key/value pairs. */
+    recordAttributes(attributes: Iterable<[string, AttributeValue]> | Record<string, AttributeValue> | null | undefined): void;
+    /** Records the input messages for telemetry tracking. */
+    protected recordInputMessages(messages: InputMessagesParam): void;
+    /** Records the output messages for telemetry tracking. */
+    protected recordOutputMessages(messages: OutputMessagesParam): void;
+    /** Sets a tag on the span if the value is not null or undefined. */
+    protected setTagMaybe<T extends string | number | boolean | string[] | number[]>(name: string, value: T | null | undefined): void;
+    /**
+     * Sets a custom end time for the scope.
+     * When set, `dispose()` will pass this value to `span.end()` instead of using wall-clock time.
+     */
+    setEndTime(endTime: TimeInput): void;
+    /** Records a cancellation event on the span. */
+    recordCancellation(reason?: string): void;
+    /** Converts a TimeInput value to milliseconds since epoch. */
+    private static timeInputToMs;
+    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/esm/a365/scopes/OpenTelemetryScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryScope.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/OpenTelemetryScope.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGvF,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AASzB;;;;GAIG;AACH,8BAAsB,kBAAkB;IACtC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,eAAe,CAAC,CAAY;IACpC,OAAO,CAAC,aAAa,CAAC,CAAY;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C;;;;;;OAMG;IACH,SAAS,aACP,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,YAAY,EAC3B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW;IAyE3B,+EAA+E;IACxE,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKrE,4CAA4C;IACrC,cAAc,IAAI,WAAW;IAIpC,2DAA2D;IACpD,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IActC,kDAAkD;IAC3C,gBAAgB,CACrB,UAAU,EACN,QAAQ,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAC9B,IAAI,GACJ,SAAS,GACZ,IAAI;IAkBP,yDAAyD;IACzD,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAKjE,0DAA0D;IAC1D,SAAS,CAAC,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAKnE,oEAAoE;IACpE,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,EAC7E,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1B,IAAI;IAQP;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAI3C,gDAAgD;IACzC,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhD,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,aAAa;IAO5B,OAAO,CAAC,GAAG;IAuBX,kEAAkE;IAC3D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAW/B,+CAA+C;IACxC,OAAO,IAAI,IAAI;CAGvB"}

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

@@ -0,0 +1,207 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { trace, SpanKind, SpanStatusCode, context } from "@opentelemetry/api";
+import { OpenTelemetryConstants } from "../constants.js";
+import { createContextWithParentSpanRef, isParentSpanRef } from "../context.js";
+import { normalizeInputMessages, normalizeOutputMessages, serializeMessages, } from "../message-utils.js";
+import { Logger } from "../../shared/logging/index.js";
+/**
+ * Base class for OpenTelemetry tracing scopes.
+ *
+ * Subclasses: `InvokeAgentScope`, `ExecuteToolScope`, `InferenceScope`, `OutputScope`.
+ */
+export class OpenTelemetryScope {
+    /**
+     * Returns a tracer from the current global TracerProvider.
+     *
+     * This **must not** be stored in a static field because the distro's
+     * `useMicrosoftOpenTelemetry()` resets the global API state
+     * (`trace.disable()` + global-object deletion) before starting the
+     * NodeSDK. A static field would capture a `ProxyTracer` bound to the
+     * old `ProxyTracerProvider` whose delegate is never set, producing
+     * `NoopSpan` instances with zeroed trace/span IDs.
+     */
+    static getTracer() {
+        return trace.getTracer(OpenTelemetryConstants.SOURCE_NAME);
+    }
+    span;
+    wallClockStartMs;
+    customStartTime;
+    customEndTime;
+    errorType;
+    hasEnded = false;
+    logger = Logger.getInstance();
+    /**
+     * @param operationName The name of the operation being traced.
+     * @param spanName The display name of the span.
+     * @param agentDetails Optional agent details. Tenant ID is read from `agentDetails.tenantId`.
+     * @param spanDetails Optional span configuration including parent context, start/end times, span kind, and span links.
+     * @param userDetails Optional human caller identity details.
+     */
+    constructor(operationName, spanName, agentDetails, spanDetails, userDetails) {
+        const parentContext = spanDetails?.parentContext;
+        const startTime = spanDetails?.startTime;
+        const endTime = spanDetails?.endTime;
+        const spanLinks = spanDetails?.spanLinks;
+        const kind = spanDetails?.spanKind ?? SpanKind.CLIENT;
+        let currentContext = context.active();
+        if (parentContext) {
+            if (isParentSpanRef(parentContext)) {
+                currentContext = createContextWithParentSpanRef(currentContext, parentContext);
+            }
+            else {
+                currentContext = parentContext;
+            }
+        }
+        this.span = OpenTelemetryScope.getTracer().startSpan(spanName, {
+            kind,
+            startTime,
+            links: spanLinks,
+            attributes: {
+                [OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY]: operationName,
+            },
+        }, currentContext);
+        this.wallClockStartMs = Date.now();
+        if (startTime !== undefined) {
+            this.customStartTime = startTime;
+        }
+        this.customEndTime = endTime;
+        // Set agent details
+        if (agentDetails) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, agentDetails.agentId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, agentDetails.agentName);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, agentDetails.agentDescription);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_PLATFORM_ID_KEY, agentDetails.platformId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_ICON_URI_KEY, agentDetails.iconUri);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, agentDetails.agentAUID);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_EMAIL_KEY, agentDetails.agentEmail);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, agentDetails.agentBlueprintId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_VERSION_KEY, agentDetails.agentVersion);
+        }
+        // Set tenant ID
+        this.setTagMaybe(OpenTelemetryConstants.TENANT_ID_KEY, agentDetails?.tenantId);
+        // Set caller details
+        if (userDetails) {
+            this.setTagMaybe(OpenTelemetryConstants.USER_ID_KEY, userDetails.userId);
+            this.setTagMaybe(OpenTelemetryConstants.USER_EMAIL_KEY, userDetails.userEmail);
+            this.setTagMaybe(OpenTelemetryConstants.USER_NAME_KEY, userDetails.userName);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_CLIENT_IP_KEY, userDetails.callerClientIp);
+        }
+    }
+    /** Makes this span active for the duration of the async callback execution. */
+    withActiveSpanAsync(callback) {
+        const newContext = trace.setSpan(context.active(), this.span);
+        return context.with(newContext, callback);
+    }
+    /** Gets the span context for this scope. */
+    getSpanContext() {
+        return this.span.spanContext();
+    }
+    /** Records an error that occurred during the operation. */
+    recordError(error) {
+        if ("status" in error && typeof error.status === "number") {
+            this.errorType = String(error.status);
+        }
+        else {
+            this.errorType = error.constructor.name;
+        }
+        this.span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error.message,
+        });
+        this.span.recordException(error);
+    }
+    /** Records multiple attribute key/value pairs. */
+    recordAttributes(attributes) {
+        if (!attributes)
+            return;
+        if (Symbol.iterator in Object(attributes) && typeof attributes !== "string") {
+            for (const [key, value] of attributes) {
+                if (key && typeof key === "string" && key.trim()) {
+                    this.span.setAttribute(key, value);
+                }
+            }
+        }
+        else if (typeof attributes === "object") {
+            for (const key of Object.keys(attributes)) {
+                if (key && key.trim()) {
+                    this.span.setAttribute(key, attributes[key]);
+                }
+            }
+        }
+    }
+    /** Records the input messages for telemetry tracking. */
+    recordInputMessages(messages) {
+        const wrapper = normalizeInputMessages(messages);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, serializeMessages(wrapper));
+    }
+    /** Records the output messages for telemetry tracking. */
+    recordOutputMessages(messages) {
+        const wrapper = normalizeOutputMessages(messages);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, serializeMessages(wrapper));
+    }
+    /** Sets a tag on the span if the value is not null or undefined. */
+    setTagMaybe(name, value) {
+        if (value != null) {
+            this.span.setAttributes({
+                [name]: value,
+            });
+        }
+    }
+    /**
+     * Sets a custom end time for the scope.
+     * When set, `dispose()` will pass this value to `span.end()` instead of using wall-clock time.
+     */
+    setEndTime(endTime) {
+        this.customEndTime = endTime;
+    }
+    /** Records a cancellation event on the span. */
+    recordCancellation(reason) {
+        const message = reason ?? "Task was cancelled";
+        this.span.setStatus({ code: SpanStatusCode.ERROR, message });
+        this.errorType = OpenTelemetryConstants.ERROR_TYPE_CANCELLED;
+    }
+    /** Converts a TimeInput value to milliseconds since epoch. */
+    static timeInputToMs(t) {
+        if (typeof t === "number")
+            return t;
+        if (t instanceof Date)
+            return t.getTime();
+        if (Array.isArray(t) && t.length === 2)
+            return t[0] * 1000 + t[1] / 1_000_000;
+        return Date.now();
+    }
+    end() {
+        if (this.hasEnded)
+            return;
+        const startMs = this.customStartTime !== undefined
+            ? OpenTelemetryScope.timeInputToMs(this.customStartTime)
+            : this.wallClockStartMs;
+        const endMs = this.customEndTime !== undefined
+            ? OpenTelemetryScope.timeInputToMs(this.customEndTime)
+            : Date.now();
+        const durationMs = Math.max(0, endMs - startMs);
+        if (this.errorType) {
+            this.span.setAttributes({ [OpenTelemetryConstants.ERROR_TYPE_KEY]: this.errorType });
+        }
+        this.hasEnded = true;
+        this.logger.info(`[A365] Ending span[${this.span.spanContext().spanId}], duration: ${(durationMs / 1000).toFixed(3)}s`);
+    }
+    /** Disposes the scope and finalizes telemetry data collection. */
+    [Symbol.dispose]() {
+        if (!this.hasEnded) {
+            this.end();
+            if (this.customEndTime !== undefined) {
+                this.span.end(this.customEndTime);
+            }
+            else {
+                this.span.end();
+            }
+        }
+    }
+    /** Legacy dispose method for compatibility. */
+    dispose() {
+        this[Symbol.dispose]();
+    }
+}
+//# sourceMappingURL=OpenTelemetryScope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryScope.js","sourceRoot":"","sources":["../../../../src/a365/scopes/OpenTelemetryScope.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AASlC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAQzD,OAAO,EAAE,8BAA8B,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD;;;;GAIG;AACH,MAAM,OAAgB,kBAAkB;IACtC;;;;;;;;;OASG;IACK,MAAM,CAAC,SAAS;QACtB,OAAO,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAEkB,IAAI,CAAO;IACb,gBAAgB,CAAS;IAClC,eAAe,CAAa;IAC5B,aAAa,CAAa;IAC1B,SAAS,CAAU;IACnB,QAAQ,GAAG,KAAK,CAAC;IACR,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE/C;;;;;;OAMG;IACH,YACE,aAAqB,EACrB,QAAgB,EAChB,YAA2B,EAC3B,WAAyB,EACzB,WAAyB;QAEzB,MAAM,aAAa,GAAG,WAAW,EAAE,aAAa,CAAC;QACjD,MAAM,SAAS,GAAG,WAAW,EAAE,SAAS,CAAC;QACzC,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,CAAC;QACrC,MAAM,SAAS,GAAG,WAAW,EAAE,SAAS,CAAC;QACzC,MAAM,IAAI,GAAG,WAAW,EAAE,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC;QAEtD,IAAI,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACtC,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;gBACnC,cAAc,GAAG,8BAA8B,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YACjF,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,aAAa,CAAC;YACjC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC,SAAS,EAAE,CAAC,SAAS,CAClD,QAAQ,EACR;YACE,IAAI;YACJ,SAAS;YACT,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE;gBACV,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,EAAE,aAAa;aAClE;SACF,EACD,cAAc,CACf,CAAC;QAEF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAE7B,oBAAoB;QACpB,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YACnF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvF,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,4BAA4B,EACnD,YAAY,CAAC,gBAAgB,CAC9B,CAAC;YACF,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,4BAA4B,EACnD,YAAY,CAAC,UAAU,CACxB,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YACnF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,sBAAsB,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACzF,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,6BAA6B,EACpD,YAAY,CAAC,gBAAgB,CAC9B,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,wBAAwB,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QAC/F,CAAC;QAED,gBAAgB;QAChB,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QAE/E,qBAAqB;QACrB,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;YACzE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,cAAc,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;YAC/E,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,aAAa,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC7E,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,2BAA2B,EAClD,WAAW,CAAC,cAAc,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+EAA+E;IACxE,mBAAmB,CAAI,QAA0B;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,4CAA4C;IACrC,cAAc;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,2DAA2D;IACpD,WAAW,CAAC,KAAY;QAC7B,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAQ,KAAiC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvF,IAAI,CAAC,SAAS,GAAG,MAAM,CAAE,KAAiC,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YAClB,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,kDAAkD;IAC3C,gBAAgB,CACrB,UAIa;QAEb,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAgD,EAAE,CAAC;gBAC5E,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAA4C,CAAC,EAAE,CAAC;gBAC5E,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;oBACtB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAG,UAA6C,CAAC,GAAG,CAAC,CAAC,CAAC;gBACnF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,yDAAyD;IAC/C,mBAAmB,CAAC,QAA4B;QACxD,MAAM,OAAO,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjG,CAAC;IAED,0DAA0D;IAChD,oBAAoB,CAAC,QAA6B;QAC1D,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,oEAAoE;IAC1D,WAAW,CACnB,IAAY,EACZ,KAA2B;QAE3B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;gBACtB,CAAC,IAAI,CAAC,EAAE,KAAwD;aACjE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAkB;QAClC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,gDAAgD;IACzC,kBAAkB,CAAC,MAAe;QACvC,MAAM,OAAO,GAAG,MAAM,IAAI,oBAAoB,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,sBAAsB,CAAC,oBAAoB,CAAC;IAC/D,CAAC;IAED,8DAA8D;IACtD,MAAM,CAAC,aAAa,CAAC,CAAY;QACvC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,IAAI;YAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QAC9E,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;IAEO,GAAG;QACT,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,MAAM,OAAO,GACX,IAAI,CAAC,eAAe,KAAK,SAAS;YAChC,CAAC,CAAC,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC;YACxD,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC5B,MAAM,KAAK,GACT,IAAI,CAAC,aAAa,KAAK,SAAS;YAC9B,CAAC,CAAC,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC;YACtD,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;QAEhD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,sBAAsB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,gBAAgB,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACtG,CAAC;IACJ,CAAC;IAED,kEAAkE;IAC3D,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,+CAA+C;IACxC,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import type { AgentDetails, UserDetails, OutputResponse, Request, SpanDetails, ResponseMessagesParam } from "../contracts.js";
+/**
+ * Provides OpenTelemetry tracing scope for output message tracing.
+ */
+export declare class OutputScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for output message tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param response The response containing initial output messages.
+     * @param agentDetails The agent producing the output. `tenantId` is required.
+     * @param userDetails Optional human caller identity details.
+     * @param spanDetails Optional span configuration.
+     */
+    static start(request: Request, response: OutputResponse, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): OutputScope;
+    private constructor();
+    /**
+     * Records the output messages for telemetry tracking.
+     * Overwrites any previously recorded output messages.
+     */
+    recordOutputMessages(messages: ResponseMessagesParam): void;
+    private _setOutput;
+    private _isRawDict;
+}
+//# sourceMappingURL=OutputScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OutputScope.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/OutputScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,EACX,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,qBAAa,WAAY,SAAQ,kBAAkB;IACjD;;;;;;;;OAQG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,WAAW;IAId,OAAO;IAiCP;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAIlE,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,UAAU;CAQnB"}

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

@@ -0,0 +1,69 @@
+// 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 { normalizeOutputMessages, serializeMessages } from "../message-utils.js";
+import { A365_MESSAGE_SCHEMA_VERSION } from "../contracts.js";
+/**
+ * Provides OpenTelemetry tracing scope for output message tracing.
+ */
+export class OutputScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for output message tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
+     * @param response The response containing initial output messages.
+     * @param agentDetails The agent producing the output. `tenantId` is required.
+     * @param userDetails Optional human caller identity details.
+     * @param spanDetails Optional span configuration.
+     */
+    static start(request, response, agentDetails, userDetails, spanDetails) {
+        return new OutputScope(request, response, agentDetails, userDetails, spanDetails);
+    }
+    constructor(request, response, agentDetails, userDetails, spanDetails) {
+        if (!agentDetails.tenantId) {
+            throw new Error("OutputScope: tenantId is required on agentDetails");
+        }
+        // spanKind for OutputScope is always CLIENT
+        const resolvedSpanDetails = { ...spanDetails, spanKind: SpanKind.CLIENT };
+        super(OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME, agentDetails.agentName
+            ? `${OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME} ${agentDetails.agentName}`
+            : `${OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME} ${agentDetails.agentId}`, agentDetails, resolvedSpanDetails, userDetails);
+        // Set initial output messages
+        this._setOutput(response.messages);
+        // 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);
+    }
+    /**
+     * Records the output messages for telemetry tracking.
+     * Overwrites any previously recorded output messages.
+     */
+    recordOutputMessages(messages) {
+        this._setOutput(messages);
+    }
+    _setOutput(messages) {
+        // Dict (Record<string, unknown>) — treat as tool call result, serialize directly
+        if (this._isRawDict(messages)) {
+            try {
+                this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, JSON.stringify(messages));
+            }
+            catch {
+                this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, JSON.stringify({ error: "serialization failed" }));
+            }
+            return;
+        }
+        const normalized = normalizeOutputMessages(messages);
+        const wrapper = { version: A365_MESSAGE_SCHEMA_VERSION, messages: normalized.messages };
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, serializeMessages(wrapper));
+    }
+    _isRawDict(messages) {
+        return (typeof messages === "object" &&
+            messages !== null &&
+            !Array.isArray(messages) &&
+            !("version" in messages && "messages" in messages));
+    }
+}
+//# sourceMappingURL=OutputScope.js.map

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

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

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

@@ -0,0 +1,6 @@
+export { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+export { InvokeAgentScope } from "./InvokeAgentScope.js";
+export { ExecuteToolScope } from "./ExecuteToolScope.js";
+export { InferenceScope } from "./InferenceScope.js";
+export { OutputScope } from "./OutputScope.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,8 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+export { InvokeAgentScope } from "./InvokeAgentScope.js";
+export { ExecuteToolScope } from "./ExecuteToolScope.js";
+export { InferenceScope } from "./InferenceScope.js";
+export { OutputScope } from "./OutputScope.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/a365/scopes/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/a365/utils/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read an environment variable, trimmed and lowercased.
+ * Returns undefined if not set or empty.
+ */
+export declare function getEnv(name: string): string | undefined;
+//# sourceMappingURL=utils.d.ts.map