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

package/dist/esm/a365/hosting/observabilityHostingManager.d.ts

@@ -0,0 +1,30 @@
+import type { MiddlewareLike } from "./types.js";
+/**
+ * Configuration options for the hosting observability layer.
+ */
+export interface ObservabilityHostingOptions {
+    /** Enable baggage propagation middleware. Defaults to false. */
+    enableBaggage?: boolean;
+    /** Enable output logging middleware for tracing outgoing messages. Defaults to false. */
+    enableOutputLogging?: boolean;
+}
+/**
+ * Manager for configuring hosting-layer observability middleware.
+ *
+ * @example
+ * ```typescript
+ * const manager = new ObservabilityHostingManager();
+ * manager.configure(adapter, { enableOutputLogging: true });
+ * ```
+ */
+export declare class ObservabilityHostingManager {
+    private _configured;
+    /**
+     * Registers observability middleware on the adapter.
+     * Subsequent calls are ignored.
+     */
+    configure(adapter: {
+        use(...middlewares: Array<MiddlewareLike>): void;
+    }, options: ObservabilityHostingOptions): void;
+}
+//# sourceMappingURL=observabilityHostingManager.d.ts.map

package/dist/esm/a365/hosting/observabilityHostingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observabilityHostingManager.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/observabilityHostingManager.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACH,SAAS,CACP,OAAO,EAAE;QAAE,GAAG,CAAC,GAAG,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,CAAA;KAAE,EAC7D,OAAO,EAAE,2BAA2B,GACnC,IAAI;CA2BR"}

package/dist/esm/a365/hosting/observabilityHostingManager.js

@@ -0,0 +1,45 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Manager for configuring hosting-layer observability middleware.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability-hosting/src/middleware/ObservabilityHostingManager.ts
+ */
+import { Logger } from "../../shared/logging/index.js";
+import { BaggageMiddleware } from "./baggageMiddleware.js";
+import { OutputLoggingMiddleware } from "./outputLoggingMiddleware.js";
+/**
+ * Manager for configuring hosting-layer observability middleware.
+ *
+ * @example
+ * ```typescript
+ * const manager = new ObservabilityHostingManager();
+ * manager.configure(adapter, { enableOutputLogging: true });
+ * ```
+ */
+export class ObservabilityHostingManager {
+    _configured = false;
+    /**
+     * Registers observability middleware on the adapter.
+     * Subsequent calls are ignored.
+     */
+    configure(adapter, options) {
+        if (this._configured) {
+            Logger.getInstance().warn("[ObservabilityHostingManager] Already configured. Subsequent configure() calls are ignored.");
+            return;
+        }
+        const enableBaggage = options.enableBaggage === true;
+        const enableOutputLogging = options.enableOutputLogging === true;
+        if (enableBaggage) {
+            adapter.use(new BaggageMiddleware());
+            Logger.getInstance().info("[ObservabilityHostingManager] BaggageMiddleware registered.");
+        }
+        if (enableOutputLogging) {
+            adapter.use(new OutputLoggingMiddleware());
+            Logger.getInstance().info("[ObservabilityHostingManager] OutputLoggingMiddleware registered.");
+        }
+        Logger.getInstance().info(`[ObservabilityHostingManager] Configured. Baggage: ${enableBaggage}, OutputLogging: ${enableOutputLogging}.`);
+        this._configured = true;
+    }
+}
+//# sourceMappingURL=observabilityHostingManager.js.map

package/dist/esm/a365/hosting/observabilityHostingManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observabilityHostingManager.js","sourceRoot":"","sources":["../../../../src/a365/hosting/observabilityHostingManager.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAcvE;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IAC9B,WAAW,GAAG,KAAK,CAAC;IAE5B;;;OAGG;IACH,SAAS,CACP,OAA6D,EAC7D,OAAoC;QAEpC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CACvB,6FAA6F,CAC9F,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,IAAI,CAAC;QACrD,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,KAAK,IAAI,CAAC;QAEjE,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;YACrC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,IAAI,uBAAuB,EAAE,CAAC,CAAC;YAC3C,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CACvB,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CACvB,sDAAsD,aAAa,oBAAoB,mBAAmB,GAAG,CAC9G,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/dist/esm/a365/hosting/outputLoggingMiddleware.d.ts

@@ -0,0 +1,24 @@
+import type { TurnContextLike, MiddlewareLike } from "./types.js";
+/**
+ * TurnState key for the parent span reference.
+ * Set this in `turnState` to link OutputScope spans as children of an InvokeAgentScope.
+ */
+export declare const A365_PARENT_SPAN_KEY = "A365ParentSpanId";
+/**
+ * TurnState key for the auth token.
+ * Set this in `turnState` so middleware can resolve the agent blueprint ID
+ * from token claims (used for embodied/agentic requests).
+ */
+export declare const A365_AUTH_TOKEN_KEY = "A365AuthToken";
+/**
+ * Middleware that creates {@link OutputScope} spans for outgoing messages.
+ * Links to a parent span when {@link A365_PARENT_SPAN_KEY} is set in turnState.
+ *
+ * **Privacy note:** Outgoing message content is captured verbatim
+ * as span attributes and exported to the configured telemetry backend.
+ */
+export declare class OutputLoggingMiddleware implements MiddlewareLike {
+    onTurn(context: TurnContextLike, next: () => Promise<void>): Promise<void>;
+    private _createSendHandler;
+}
+//# sourceMappingURL=outputLoggingMiddleware.d.ts.map

package/dist/esm/a365/hosting/outputLoggingMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputLoggingMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/outputLoggingMiddleware.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IACtD,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhF,OAAO,CAAC,kBAAkB;CAmD3B"}

package/dist/esm/a365/hosting/outputLoggingMiddleware.js

@@ -0,0 +1,78 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Middleware that creates OutputScope spans for outgoing messages.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability-hosting/src/middleware/OutputLoggingMiddleware.ts
+ */
+import { OutputScope } from "../scopes/index.js";
+import { ScopeUtils } from "./scopeUtils.js";
+import { Logger } from "../../shared/logging/index.js";
+/**
+ * TurnState key for the parent span reference.
+ * Set this in `turnState` to link OutputScope spans as children of an InvokeAgentScope.
+ */
+export const A365_PARENT_SPAN_KEY = "A365ParentSpanId";
+/**
+ * TurnState key for the auth token.
+ * Set this in `turnState` so middleware can resolve the agent blueprint ID
+ * from token claims (used for embodied/agentic requests).
+ */
+export const A365_AUTH_TOKEN_KEY = "A365AuthToken";
+/**
+ * Middleware that creates {@link OutputScope} spans for outgoing messages.
+ * Links to a parent span when {@link A365_PARENT_SPAN_KEY} is set in turnState.
+ *
+ * **Privacy note:** Outgoing message content is captured verbatim
+ * as span attributes and exported to the configured telemetry backend.
+ */
+export class OutputLoggingMiddleware {
+    async onTurn(context, next) {
+        const authToken = context.turnState.get(A365_AUTH_TOKEN_KEY) ?? "";
+        const agentDetails = ScopeUtils.deriveAgentDetails(context, authToken);
+        if (!agentDetails || !agentDetails.tenantId) {
+            await next();
+            return;
+        }
+        const userDetails = ScopeUtils.deriveCallerDetails(context);
+        const conversationId = ScopeUtils.deriveConversationId(context);
+        const channel = ScopeUtils.deriveChannelObject(context);
+        const request = {
+            conversationId,
+            channel,
+        };
+        if (context.onSendActivities) {
+            context.onSendActivities(this._createSendHandler(context, agentDetails, userDetails, request));
+        }
+        await next();
+    }
+    _createSendHandler(turnContext, agentDetails, userDetails, request) {
+        return async (_ctx, activities, sendNext) => {
+            const messages = activities.filter((a) => a.type === "message" && a.text).map((a) => a.text);
+            if (messages.length === 0) {
+                return await sendNext();
+            }
+            const parentSpanRef = turnContext.turnState.get(A365_PARENT_SPAN_KEY);
+            if (!parentSpanRef) {
+                Logger.getInstance().warn(`[OutputLoggingMiddleware] No parent span ref in turnState under '${A365_PARENT_SPAN_KEY}'. OutputScope will not be linked to a parent.`);
+            }
+            const spanDetails = parentSpanRef
+                ? { parentContext: parentSpanRef }
+                : undefined;
+            const outputScope = OutputScope.start(request ?? {}, { messages }, agentDetails, userDetails, spanDetails);
+            try {
+                return await sendNext();
+            }
+            catch (error) {
+                outputScope.recordError(error instanceof Error
+                    ? error
+                    : new Error(typeof error === "string" ? error : JSON.stringify(error)));
+                throw error;
+            }
+            finally {
+                outputScope.dispose();
+            }
+        };
+    }
+}
+//# sourceMappingURL=outputLoggingMiddleware.js.map

package/dist/esm/a365/hosting/outputLoggingMiddleware.js.map

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

package/dist/esm/a365/hosting/scopeUtils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Utilities to populate scope parameters from a TurnContext.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability-hosting/src/utils/ScopeUtils.ts
+ */
+import type { SpanKind, TimeInput } from "@opentelemetry/api";
+import type { TurnContextLike } from "./types.js";
+import { InvokeAgentScope, InferenceScope, ExecuteToolScope } from "../scopes/index.js";
+import type { AgentDetails, UserDetails, InvokeAgentScopeDetails, ToolCallDetails, InferenceDetails } from "../contracts.js";
+/**
+ * Unified utilities to populate scope tags from a TurnContext.
+ */
+export declare class ScopeUtils {
+    /**
+     * Derive target agent details from the activity recipient.
+     */
+    static deriveAgentDetails(turnContext: TurnContextLike, authToken: string): AgentDetails | undefined;
+    /**
+     * Derive caller agent details from the activity from.
+     */
+    static deriveCallerAgent(turnContext: TurnContextLike): AgentDetails | undefined;
+    /**
+     * Derive caller identity details (id, email, name, tenant) from the activity from.
+     */
+    static deriveCallerDetails(turnContext: TurnContextLike): UserDetails | undefined;
+    /**
+     * Derive conversation id from the TurnContext.
+     */
+    static deriveConversationId(turnContext: TurnContextLike): string | undefined;
+    /**
+     * Derive channel (name and description) from the TurnContext.
+     */
+    static deriveChannelObject(turnContext: TurnContextLike): {
+        name?: string;
+        description?: string;
+    };
+    private static setInputMessageTags;
+    /**
+     * Create an `InferenceScope` enriched with values from the TurnContext.
+     */
+    static populateInferenceScopeFromTurnContext(details: InferenceDetails, turnContext: TurnContextLike, authToken: string, startTime?: TimeInput, endTime?: TimeInput): InferenceScope;
+    /**
+     * Create an `InvokeAgentScope` enriched with values from the TurnContext.
+     */
+    static populateInvokeAgentScopeFromTurnContext(details: AgentDetails, scopeDetails: InvokeAgentScopeDetails, turnContext: TurnContextLike, authToken: string, startTime?: TimeInput, endTime?: TimeInput, spanKind?: SpanKind): InvokeAgentScope;
+    /**
+     * Build agent details by merging provided details with TurnContext.
+     */
+    static buildInvokeAgentDetails(details: AgentDetails, turnContext: TurnContextLike, authToken: string): AgentDetails;
+    private static buildInvokeAgentDetailsCore;
+    /**
+     * Create an `ExecuteToolScope` enriched with values from the TurnContext.
+     */
+    static populateExecuteToolScopeFromTurnContext(details: ToolCallDetails, turnContext: TurnContextLike, authToken: string, startTime?: TimeInput, endTime?: TimeInput, spanKind?: SpanKind): ExecuteToolScope;
+}
+//# sourceMappingURL=scopeUtils.d.ts.map

package/dist/esm/a365/hosting/scopeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeUtils.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/scopeUtils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAIX,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,UAAU;IAGrB;;OAEG;WACW,kBAAkB,CAC9B,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,GAChB,YAAY,GAAG,SAAS;IAe3B;;OAEG;WACW,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,YAAY,GAAG,SAAS;IAcvF;;OAEG;WACW,mBAAmB,CAAC,WAAW,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS;IAWxF;;OAEG;WACW,oBAAoB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS;IAIpF;;OAEG;WACW,mBAAmB,CAAC,WAAW,EAAE,eAAe,GAAG;QAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IASD,OAAO,CAAC,MAAM,CAAC,mBAAmB;IASlC;;OAEG;IACH,MAAM,CAAC,qCAAqC,CAC1C,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,SAAS,GAClB,cAAc;IA0BjB;;OAEG;IACH,MAAM,CAAC,uCAAuC,CAC5C,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,uBAAuB,EACrC,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,QAAQ,GAClB,gBAAgB;IAiCnB;;OAEG;WACW,uBAAuB,CACnC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,GAChB,YAAY;IAIf,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAY1C;;OAEG;IACH,MAAM,CAAC,uCAAuC,CAC5C,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,QAAQ,GAClB,gBAAgB;CAuBpB"}

package/dist/esm/a365/hosting/scopeUtils.js

@@ -0,0 +1,157 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { resolveEmbodiedAgentIds } from "./turnContextUtils.js";
+import { InvokeAgentScope, InferenceScope, ExecuteToolScope } from "../scopes/index.js";
+/**
+ * Unified utilities to populate scope tags from a TurnContext.
+ */
+export class ScopeUtils {
+    // ── Context-derived helpers ─────────────────────────────────────
+    /**
+     * Derive target agent details from the activity recipient.
+     */
+    static deriveAgentDetails(turnContext, authToken) {
+        const recipient = turnContext?.activity?.recipient;
+        if (!recipient)
+            return undefined;
+        const { agentId, agentBlueprintId } = resolveEmbodiedAgentIds(turnContext, authToken);
+        return {
+            agentId,
+            agentName: recipient.name,
+            agentAUID: recipient.aadObjectId,
+            agentBlueprintId,
+            agentEmail: turnContext?.activity?.getAgenticUser?.(),
+            agentDescription: recipient.role,
+            tenantId: turnContext?.activity?.getAgenticTenantId?.(),
+        };
+    }
+    /**
+     * Derive caller agent details from the activity from.
+     */
+    static deriveCallerAgent(turnContext) {
+        const from = turnContext?.activity?.from;
+        if (!from)
+            return undefined;
+        return {
+            agentBlueprintId: from.agenticAppBlueprintId,
+            agentName: from.name,
+            agentAUID: from.aadObjectId,
+            agentDescription: from.role,
+            tenantId: from.tenantId,
+            agentId: from.agenticAppId,
+            agentEmail: from.agenticUserId,
+        };
+    }
+    /**
+     * Derive caller identity details (id, email, name, tenant) from the activity from.
+     */
+    static deriveCallerDetails(turnContext) {
+        const from = turnContext?.activity?.from;
+        if (!from)
+            return undefined;
+        return {
+            userId: from.aadObjectId,
+            userEmail: from.agenticUserId,
+            userName: from.name,
+            tenantId: from.tenantId,
+        };
+    }
+    /**
+     * Derive conversation id from the TurnContext.
+     */
+    static deriveConversationId(turnContext) {
+        return turnContext?.activity?.conversation?.id;
+    }
+    /**
+     * Derive channel (name and description) from the TurnContext.
+     */
+    static deriveChannelObject(turnContext) {
+        return {
+            name: turnContext?.activity?.channelId,
+            description: turnContext?.activity?.channelIdSubChannel,
+        };
+    }
+    // ── Scope factory helpers ───────────────────────────────────────
+    static setInputMessageTags(scope, turnContext) {
+        if (turnContext?.activity?.text) {
+            scope.recordInputMessages([turnContext.activity.text]);
+        }
+    }
+    /**
+     * Create an `InferenceScope` enriched with values from the TurnContext.
+     */
+    static populateInferenceScopeFromTurnContext(details, turnContext, authToken, startTime, endTime) {
+        const agent = ScopeUtils.deriveAgentDetails(turnContext, authToken);
+        const caller = ScopeUtils.deriveCallerDetails(turnContext);
+        const conversationId = ScopeUtils.deriveConversationId(turnContext);
+        const channel = ScopeUtils.deriveChannelObject(turnContext);
+        if (!agent) {
+            throw new Error("populateInferenceScopeFromTurnContext: Missing agent details on TurnContext (recipient)");
+        }
+        const hasChannel = channel.name !== undefined || channel.description !== undefined;
+        const request = {
+            conversationId,
+            ...(hasChannel ? { channel: { name: channel.name, description: channel.description } } : {}),
+        };
+        const spanDetails = startTime || endTime ? { startTime, endTime } : undefined;
+        const scope = InferenceScope.start(request, details, agent, caller, spanDetails);
+        this.setInputMessageTags(scope, turnContext);
+        return scope;
+    }
+    /**
+     * Create an `InvokeAgentScope` enriched with values from the TurnContext.
+     */
+    static populateInvokeAgentScopeFromTurnContext(details, scopeDetails, turnContext, authToken, startTime, endTime, spanKind) {
+        const callerAgent = ScopeUtils.deriveCallerAgent(turnContext);
+        const caller = ScopeUtils.deriveCallerDetails(turnContext);
+        const conversationId = ScopeUtils.deriveConversationId(turnContext);
+        const channel = ScopeUtils.deriveChannelObject(turnContext);
+        const agentDetails = ScopeUtils.buildInvokeAgentDetailsCore(details, turnContext, authToken);
+        const hasChannel = channel.name !== undefined || channel.description !== undefined;
+        const request = {
+            conversationId,
+            ...(hasChannel ? { channel: { name: channel.name, description: channel.description } } : {}),
+        };
+        const callerDetails = {
+            userDetails: caller,
+            callerAgentDetails: callerAgent,
+        };
+        const spanDetailsObj = startTime || endTime || spanKind ? { startTime, endTime, spanKind } : undefined;
+        const scope = InvokeAgentScope.start(request, scopeDetails, agentDetails, callerDetails, spanDetailsObj);
+        this.setInputMessageTags(scope, turnContext);
+        return scope;
+    }
+    /**
+     * Build agent details by merging provided details with TurnContext.
+     */
+    static buildInvokeAgentDetails(details, turnContext, authToken) {
+        return ScopeUtils.buildInvokeAgentDetailsCore(details, turnContext, authToken);
+    }
+    static buildInvokeAgentDetailsCore(details, turnContext, authToken) {
+        const derivedAgentDetails = ScopeUtils.deriveAgentDetails(turnContext, authToken);
+        return {
+            ...details,
+            ...(derivedAgentDetails ?? {}),
+        };
+    }
+    /**
+     * Create an `ExecuteToolScope` enriched with values from the TurnContext.
+     */
+    static populateExecuteToolScopeFromTurnContext(details, turnContext, authToken, startTime, endTime, spanKind) {
+        const agent = ScopeUtils.deriveAgentDetails(turnContext, authToken);
+        const caller = ScopeUtils.deriveCallerDetails(turnContext);
+        const conversationId = ScopeUtils.deriveConversationId(turnContext);
+        const channel = ScopeUtils.deriveChannelObject(turnContext);
+        if (!agent) {
+            throw new Error("populateExecuteToolScopeFromTurnContext: Missing agent details on TurnContext (recipient)");
+        }
+        const hasChannel = channel.name !== undefined || channel.description !== undefined;
+        const request = {
+            conversationId,
+            ...(hasChannel ? { channel: { name: channel.name, description: channel.description } } : {}),
+        };
+        const spanDetailsObj = startTime || endTime || spanKind ? { startTime, endTime, spanKind } : undefined;
+        return ExecuteToolScope.start(request, details, agent, caller, spanDetailsObj);
+    }
+}
+//# sourceMappingURL=scopeUtils.js.map

package/dist/esm/a365/hosting/scopeUtils.js.map

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

package/dist/esm/a365/hosting/turnContextUtils.d.ts

@@ -0,0 +1,32 @@
+import type { TurnContextLike } from "./types.js";
+/**
+ * Extracts caller-related OpenTelemetry baggage pairs from the TurnContext.
+ */
+export declare function getCallerBaggagePairs(turnContext: TurnContextLike): Array<[string, string]>;
+/**
+ * Resolves the agent instance ID and blueprint ID for embodied (agentic) agents.
+ * For non-embodied agents, both fields are undefined.
+ * @param turnContext Activity context
+ * @param authToken Auth token for resolving blueprint ID from token claims.
+ */
+export declare function resolveEmbodiedAgentIds(turnContext: TurnContextLike, authToken: string): {
+    agentId: string | undefined;
+    agentBlueprintId: string | undefined;
+};
+/**
+ * Extracts agent/recipient-related OpenTelemetry baggage pairs from the TurnContext.
+ */
+export declare function getTargetAgentBaggagePairs(turnContext: TurnContextLike, authToken?: string): Array<[string, string]>;
+/**
+ * Extracts the tenant ID baggage key-value pair.
+ */
+export declare function getTenantIdPair(turnContext: TurnContextLike): Array<[string, string]>;
+/**
+ * Extracts channel baggage pairs from the TurnContext.
+ */
+export declare function getChannelBaggagePairs(turnContext: TurnContextLike): Array<[string, string]>;
+/**
+ * Extracts conversation ID and item link baggage pairs.
+ */
+export declare function getConversationIdAndItemLinkPairs(turnContext: TurnContextLike): Array<[string, string]>;
+//# sourceMappingURL=turnContextUtils.d.ts.map

package/dist/esm/a365/hosting/turnContextUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnContextUtils.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/turnContextUtils.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,eAAe,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAY3F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAQvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,eAAe,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmBzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,eAAe,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAGrF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,eAAe,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAY5F;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,eAAe,GAC3B,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAWzB"}

package/dist/esm/a365/hosting/turnContextUtils.js

@@ -0,0 +1,133 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * TurnContext utility methods for extracting OpenTelemetry baggage pairs.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability-hosting/src/utils/TurnContextUtils.ts
+ */
+import { OpenTelemetryConstants } from "../constants.js";
+function normalizePairs(pairs) {
+    return pairs
+        .filter(([, v]) => v != null && String(v).trim() !== "")
+        .map(([k, v]) => [k, String(v)]);
+}
+/**
+ * Extracts caller-related OpenTelemetry baggage pairs from the TurnContext.
+ */
+export function getCallerBaggagePairs(turnContext) {
+    if (!turnContext?.activity?.from) {
+        return [];
+    }
+    const from = turnContext.activity.from;
+    const pairs = [
+        [OpenTelemetryConstants.USER_ID_KEY, from.aadObjectId],
+        [OpenTelemetryConstants.USER_NAME_KEY, from.name],
+        [OpenTelemetryConstants.USER_EMAIL_KEY, from.agenticUserId],
+        [OpenTelemetryConstants.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY, from.agenticAppBlueprintId],
+    ];
+    return normalizePairs(pairs);
+}
+/**
+ * Resolves the agent instance ID and blueprint ID for embodied (agentic) agents.
+ * For non-embodied agents, both fields are undefined.
+ * @param turnContext Activity context
+ * @param authToken Auth token for resolving blueprint ID from token claims.
+ */
+export function resolveEmbodiedAgentIds(turnContext, authToken) {
+    const isAgentic = turnContext?.activity?.isAgenticRequest?.();
+    const rawAgentId = isAgentic ? turnContext.activity.getAgenticInstanceId?.() : undefined;
+    const rawBlueprintId = isAgentic ? getAgentIdFromToken(authToken) : undefined;
+    return {
+        agentId: rawAgentId || undefined,
+        agentBlueprintId: rawBlueprintId || undefined,
+    };
+}
+/**
+ * Extracts agent/recipient-related OpenTelemetry baggage pairs from the TurnContext.
+ */
+export function getTargetAgentBaggagePairs(turnContext, authToken) {
+    if (!turnContext?.activity?.recipient) {
+        return [];
+    }
+    const recipient = turnContext.activity.recipient;
+    const { agentId } = authToken
+        ? resolveEmbodiedAgentIds(turnContext, authToken)
+        : {
+            agentId: turnContext.activity?.isAgenticRequest?.()
+                ? turnContext.activity.getAgenticInstanceId?.()
+                : undefined,
+        };
+    const pairs = [
+        [OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, agentId],
+        [OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, recipient.name],
+        [OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, recipient.role],
+        [OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, recipient.aadObjectId],
+    ];
+    return normalizePairs(pairs);
+}
+/**
+ * Extracts the tenant ID baggage key-value pair.
+ */
+export function getTenantIdPair(turnContext) {
+    const tenantId = turnContext.activity?.getAgenticTenantId?.();
+    return tenantId ? [[OpenTelemetryConstants.TENANT_ID_KEY, tenantId]] : [];
+}
+/**
+ * Extracts channel baggage pairs from the TurnContext.
+ */
+export function getChannelBaggagePairs(turnContext) {
+    if (!turnContext) {
+        return [];
+    }
+    const pairs = [
+        [OpenTelemetryConstants.CHANNEL_NAME_KEY, turnContext.activity?.channelId],
+        [
+            OpenTelemetryConstants.CHANNEL_LINK_KEY,
+            turnContext.activity?.channelIdSubChannel,
+        ],
+    ];
+    return normalizePairs(pairs);
+}
+/**
+ * Extracts conversation ID and item link baggage pairs.
+ */
+export function getConversationIdAndItemLinkPairs(turnContext) {
+    if (!turnContext) {
+        return [];
+    }
+    const conversationId = turnContext.activity?.conversation?.id;
+    const itemLink = turnContext.activity?.serviceUrl;
+    const pairs = [
+        [OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, conversationId],
+        [OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY, itemLink],
+    ];
+    return normalizePairs(pairs);
+}
+// ---------------------------------------------------------------------------
+// Inline token decode (replaces @microsoft/agents-a365-runtime Utility)
+// ---------------------------------------------------------------------------
+/**
+ * Decode the JWT and return the best available agent identifier.
+ * Priority: xms_par_app_azp > appid > azp.
+ *
+ * WARNING: NO SIGNATURE VERIFICATION — suitable only for logging/diagnostics.
+ */
+function getAgentIdFromToken(token) {
+    if (!token || token.trim() === "")
+        return "";
+    try {
+        const parts = token.split(".");
+        if (parts.length < 2)
+            return "";
+        const padded = parts[1] + "=".repeat((4 - (parts[1].length % 4)) % 4);
+        const decoded = JSON.parse(Buffer.from(padded, "base64").toString("utf8"));
+        return (decoded["xms_par_app_azp"] ||
+            decoded["appid"] ||
+            decoded["azp"] ||
+            "");
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=turnContextUtils.js.map

package/dist/esm/a365/hosting/turnContextUtils.js.map

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