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

package/dist/commonjs/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/commonjs/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/commonjs/a365/hosting/outputLoggingMiddleware.js

@@ -0,0 +1,82 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputLoggingMiddleware = exports.A365_AUTH_TOKEN_KEY = exports.A365_PARENT_SPAN_KEY = void 0;
+/**
+ * Middleware that creates OutputScope spans for outgoing messages.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability-hosting/src/middleware/OutputLoggingMiddleware.ts
+ */
+const index_js_1 = require("../scopes/index.js");
+const scopeUtils_js_1 = require("./scopeUtils.js");
+const index_js_2 = require("../../shared/logging/index.js");
+/**
+ * TurnState key for the parent span reference.
+ * Set this in `turnState` to link OutputScope spans as children of an InvokeAgentScope.
+ */
+exports.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).
+ */
+exports.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.
+ */
+class OutputLoggingMiddleware {
+    async onTurn(context, next) {
+        const authToken = context.turnState.get(exports.A365_AUTH_TOKEN_KEY) ?? "";
+        const agentDetails = scopeUtils_js_1.ScopeUtils.deriveAgentDetails(context, authToken);
+        if (!agentDetails || !agentDetails.tenantId) {
+            await next();
+            return;
+        }
+        const userDetails = scopeUtils_js_1.ScopeUtils.deriveCallerDetails(context);
+        const conversationId = scopeUtils_js_1.ScopeUtils.deriveConversationId(context);
+        const channel = scopeUtils_js_1.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(exports.A365_PARENT_SPAN_KEY);
+            if (!parentSpanRef) {
+                index_js_2.Logger.getInstance().warn(`[OutputLoggingMiddleware] No parent span ref in turnState under '${exports.A365_PARENT_SPAN_KEY}'. OutputScope will not be linked to a parent.`);
+            }
+            const spanDetails = parentSpanRef
+                ? { parentContext: parentSpanRef }
+                : undefined;
+            const outputScope = index_js_1.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();
+            }
+        };
+    }
+}
+exports.OutputLoggingMiddleware = OutputLoggingMiddleware;
+//# sourceMappingURL=outputLoggingMiddleware.js.map

package/dist/commonjs/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/commonjs/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/commonjs/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/commonjs/a365/hosting/scopeUtils.js

@@ -0,0 +1,161 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeUtils = void 0;
+const turnContextUtils_js_1 = require("./turnContextUtils.js");
+const index_js_1 = require("../scopes/index.js");
+/**
+ * Unified utilities to populate scope tags from a TurnContext.
+ */
+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 } = (0, turnContextUtils_js_1.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 = index_js_1.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 = index_js_1.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 index_js_1.ExecuteToolScope.start(request, details, agent, caller, spanDetailsObj);
+    }
+}
+exports.ScopeUtils = ScopeUtils;
+//# sourceMappingURL=scopeUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scopeUtils.js","sourceRoot":"","sources":["../../../../src/a365/hosting/scopeUtils.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAUlC,+DAAgE;AAChE,iDAAwF;AAYxF;;GAEG;AACH,MAAa,UAAU;IACrB,mEAAmE;IAEnE;;OAEG;IACI,MAAM,CAAC,kBAAkB,CAC9B,WAA4B,EAC5B,SAAiB;QAEjB,MAAM,SAAS,GAAG,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC;QACnD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAA,6CAAuB,EAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACtF,OAAO;YACL,OAAO;YACP,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,SAAS,EAAE,SAAS,CAAC,WAAW;YAChC,gBAAgB;YAChB,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE;YACrD,gBAAgB,EAAE,SAAS,CAAC,IAAI;YAChC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE;SACxC,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,iBAAiB,CAAC,WAA4B;QAC1D,MAAM,IAAI,GAAG,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,qBAAqB;YAC5C,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,SAAS,EAAE,IAAI,CAAC,WAAW;YAC3B,gBAAgB,EAAE,IAAI,CAAC,IAAI;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,UAAU,EAAE,IAAI,CAAC,aAAa;SACf,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,mBAAmB,CAAC,WAA4B;QAC5D,MAAM,IAAI,GAAG,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,SAAS,EAAE,IAAI,CAAC,aAAa;YAC7B,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACT,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,oBAAoB,CAAC,WAA4B;QAC7D,OAAO,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,mBAAmB,CAAC,WAA4B;QAI5D,OAAO;YACL,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS;YACtC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAyC;SAC9E,CAAC;IACJ,CAAC;IAED,mEAAmE;IAE3D,MAAM,CAAC,mBAAmB,CAChC,KAAwC,EACxC,WAA4B;QAE5B,IAAI,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAChC,KAAK,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,qCAAqC,CAC1C,OAAyB,EACzB,WAA4B,EAC5B,SAAiB,EACjB,SAAqB,EACrB,OAAmB;QAEnB,MAAM,KAAK,GAAG,UAAU,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,UAAU,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAE5D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QACnF,MAAM,OAAO,GAAY;YACvB,cAAc;YACd,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7F,CAAC;QAEF,MAAM,WAAW,GACf,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAE5D,MAAM,KAAK,GAAG,yBAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjF,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uCAAuC,CAC5C,OAAqB,EACrB,YAAqC,EACrC,WAA4B,EAC5B,SAAiB,EACjB,SAAqB,EACrB,OAAmB,EACnB,QAAmB;QAEnB,MAAM,WAAW,GAAG,UAAU,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAE5D,MAAM,YAAY,GAAG,UAAU,CAAC,2BAA2B,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QAE7F,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QACnF,MAAM,OAAO,GAAY;YACvB,cAAc;YACd,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7F,CAAC;QAEF,MAAM,aAAa,GAAkB;YACnC,WAAW,EAAE,MAAM;YACnB,kBAAkB,EAAE,WAAW;SAChC,CAAC;QAEF,MAAM,cAAc,GAClB,SAAS,IAAI,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAElF,MAAM,KAAK,GAAG,2BAAgB,CAAC,KAAK,CAClC,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,CACf,CAAC;QACF,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,uBAAuB,CACnC,OAAqB,EACrB,WAA4B,EAC5B,SAAiB;QAEjB,OAAO,UAAU,CAAC,2BAA2B,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC;IAEO,MAAM,CAAC,2BAA2B,CACxC,OAAqB,EACrB,WAA4B,EAC5B,SAAiB;QAEjB,MAAM,mBAAmB,GAAG,UAAU,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAClF,OAAO;YACL,GAAG,OAAO;YACV,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uCAAuC,CAC5C,OAAwB,EACxB,WAA4B,EAC5B,SAAiB,EACjB,SAAqB,EACrB,OAAmB,EACnB,QAAmB;QAEnB,MAAM,KAAK,GAAG,UAAU,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,UAAU,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAE5D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QACnF,MAAM,OAAO,GAAY;YACvB,cAAc;YACd,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7F,CAAC;QAEF,MAAM,cAAc,GAClB,SAAS,IAAI,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAElF,OAAO,2BAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACjF,CAAC;CACF;AA7ND,gCA6NC"}

package/dist/commonjs/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/commonjs/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/commonjs/a365/hosting/turnContextUtils.js

@@ -0,0 +1,141 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCallerBaggagePairs = getCallerBaggagePairs;
+exports.resolveEmbodiedAgentIds = resolveEmbodiedAgentIds;
+exports.getTargetAgentBaggagePairs = getTargetAgentBaggagePairs;
+exports.getTenantIdPair = getTenantIdPair;
+exports.getChannelBaggagePairs = getChannelBaggagePairs;
+exports.getConversationIdAndItemLinkPairs = getConversationIdAndItemLinkPairs;
+/**
+ * TurnContext utility methods for extracting OpenTelemetry baggage pairs.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability-hosting/src/utils/TurnContextUtils.ts
+ */
+const constants_js_1 = require("../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.
+ */
+function getCallerBaggagePairs(turnContext) {
+    if (!turnContext?.activity?.from) {
+        return [];
+    }
+    const from = turnContext.activity.from;
+    const pairs = [
+        [constants_js_1.OpenTelemetryConstants.USER_ID_KEY, from.aadObjectId],
+        [constants_js_1.OpenTelemetryConstants.USER_NAME_KEY, from.name],
+        [constants_js_1.OpenTelemetryConstants.USER_EMAIL_KEY, from.agenticUserId],
+        [constants_js_1.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.
+ */
+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.
+ */
+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 = [
+        [constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, agentId],
+        [constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, recipient.name],
+        [constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, recipient.role],
+        [constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, recipient.aadObjectId],
+    ];
+    return normalizePairs(pairs);
+}
+/**
+ * Extracts the tenant ID baggage key-value pair.
+ */
+function getTenantIdPair(turnContext) {
+    const tenantId = turnContext.activity?.getAgenticTenantId?.();
+    return tenantId ? [[constants_js_1.OpenTelemetryConstants.TENANT_ID_KEY, tenantId]] : [];
+}
+/**
+ * Extracts channel baggage pairs from the TurnContext.
+ */
+function getChannelBaggagePairs(turnContext) {
+    if (!turnContext) {
+        return [];
+    }
+    const pairs = [
+        [constants_js_1.OpenTelemetryConstants.CHANNEL_NAME_KEY, turnContext.activity?.channelId],
+        [
+            constants_js_1.OpenTelemetryConstants.CHANNEL_LINK_KEY,
+            turnContext.activity?.channelIdSubChannel,
+        ],
+    ];
+    return normalizePairs(pairs);
+}
+/**
+ * Extracts conversation ID and item link baggage pairs.
+ */
+function getConversationIdAndItemLinkPairs(turnContext) {
+    if (!turnContext) {
+        return [];
+    }
+    const conversationId = turnContext.activity?.conversation?.id;
+    const itemLink = turnContext.activity?.serviceUrl;
+    const pairs = [
+        [constants_js_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, conversationId],
+        [constants_js_1.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/commonjs/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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"}

package/dist/commonjs/a365/hosting/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Minimal interfaces for hosting-layer observability middleware.
+ *
+ * These types mirror the shapes from `@microsoft/agents-hosting` and
+ * `@microsoft/agents-activity` so the hosting utilities can be used
+ * without taking a dependency on those packages directly. Consumers
+ * using agents-hosting can pass their TurnContext/Middleware instances
+ * directly since they satisfy these interfaces structurally.
+ */
+/** Minimal activity shape required by hosting observability utilities. */
+export interface ActivityLike {
+    type?: string;
+    name?: string;
+    text?: string;
+    channelId?: string;
+    channelIdSubChannel?: string | unknown;
+    serviceUrl?: string;
+    from?: {
+        aadObjectId?: string;
+        name?: string;
+        role?: string;
+        tenantId?: string;
+        agenticUserId?: string;
+        agenticAppBlueprintId?: string;
+        agenticAppId?: string;
+    };
+    recipient?: {
+        aadObjectId?: string;
+        name?: string;
+        role?: string;
+    };
+    conversation?: {
+        id?: string;
+    };
+    isAgenticRequest?: () => boolean;
+    getAgenticInstanceId?: () => string;
+    getAgenticTenantId?: () => string;
+    getAgenticUser?: () => string;
+}
+/** Minimal turn context shape required by hosting observability utilities. */
+export interface TurnContextLike {
+    activity: ActivityLike;
+    turnState: Map<string, unknown>;
+    onSendActivities?(handler: SendActivitiesHandler): void;
+}
+/** Handler for intercepting outgoing activities. */
+export type SendActivitiesHandler = (ctx: TurnContextLike, activities: ActivityLike[], sendNext: () => Promise<unknown[]>) => Promise<unknown[]>;
+/** Middleware interface compatible with agents-hosting adapters. */
+export interface MiddlewareLike {
+    onTurn(context: TurnContextLike, next: () => Promise<void>): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commonjs/a365/hosting/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/types.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,CAAC,EAAE;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,MAAM,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,gBAAgB,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD;AAED,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,GAAG,CAClC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,YAAY,EAAE,EAC1B,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAExB,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E"}

package/dist/commonjs/a365/hosting/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/commonjs/a365/hosting/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/a365/hosting/types.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/commonjs/a365/index.d.ts

@@ -13,4 +13,6 @@ export { BaggageBuilder, BaggageScope } from "./middleware/index.js";
 export { A365SpanProcessor, PerRequestSpanProcessor, GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES, } from "./processors/index.js";
 export type { PerRequestSpanProcessorOptions } from "./processors/index.js";
 export { runWithExportToken, updateExportToken, getExportToken } from "./context/tokenContext.js";
+export { BaggageBuilderUtils, ScopeUtils, getCallerBaggagePairs, getTargetAgentBaggagePairs, getTenantIdPair, getChannelBaggagePairs, getConversationIdAndItemLinkPairs, resolveEmbodiedAgentIds, BaggageMiddleware, OutputLoggingMiddleware, A365_PARENT_SPAN_KEY, A365_AUTH_TOKEN_KEY, ObservabilityHostingManager, } from "./hosting/index.js";
+export type { ObservabilityHostingOptions, TurnContextLike, ActivityLike, MiddlewareLike, SendActivitiesHandler, } from "./hosting/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/commonjs/a365/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGlG,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,eAAe,EACf,YAAY,EACZ,cAAc,EACd,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}