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

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

@@ -0,0 +1,18 @@
+export { A365Configuration, A365_ENV_VARS } from "./configuration/index.js";
+export type { A365Options, ClusterCategory, A365BaggageOptions, A365HostingOptions, } from "./configuration/index.js";
+export { Agent365Exporter } from "./exporter/index.js";
+export type { Agent365ExporterOptions, TokenResolver } from "./exporter/index.js";
+export { ResolvedExporterOptions } from "./exporter/index.js";
+export { OpenTelemetryScope, InvokeAgentScope, ExecuteToolScope, InferenceScope, OutputScope, } from "./scopes/index.js";
+export { OpenTelemetryConstants } from "./constants.js";
+export { MessageRole, FinishReason, Modality, InvocationRole, InferenceOperationType, A365_MESSAGE_SCHEMA_VERSION, } from "./contracts.js";
+export type { ChatMessage, InputMessages, OutputMessage, OutputMessages, InputMessagesParam, OutputMessagesParam, ResponseMessagesParam, MessagePart, TextPart, ToolCallRequestPart, ToolCallResponsePart, ReasoningPart, AgentDetails, UserDetails, CallerDetails, Request, Channel, ServiceEndpoint, InvokeAgentScopeDetails, ToolCallDetails, InferenceDetails, InferenceResponse, OutputResponse, SpanDetails, ParentSpanRef, ParentContext, } from "./contracts.js";
+export { isParentSpanRef, createContextWithParentSpanRef, runWithParentSpanRef, injectContextToHeaders, extractContextFromHeaders, runWithExtractedTraceContext, } from "./context.js";
+export type { HeadersCarrier } from "./context.js";
+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

@@ -0,0 +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;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"}

package/dist/commonjs/a365/index.js

@@ -0,0 +1,69 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityHostingManager = exports.A365_AUTH_TOKEN_KEY = exports.A365_PARENT_SPAN_KEY = exports.OutputLoggingMiddleware = exports.BaggageMiddleware = exports.resolveEmbodiedAgentIds = exports.getConversationIdAndItemLinkPairs = exports.getChannelBaggagePairs = exports.getTenantIdPair = exports.getTargetAgentBaggagePairs = exports.getCallerBaggagePairs = exports.ScopeUtils = exports.BaggageBuilderUtils = exports.getExportToken = exports.updateExportToken = exports.runWithExportToken = exports.INVOKE_AGENT_ATTRIBUTES = exports.GENERIC_ATTRIBUTES = exports.PerRequestSpanProcessor = exports.A365SpanProcessor = exports.BaggageScope = exports.BaggageBuilder = exports.runWithExtractedTraceContext = exports.extractContextFromHeaders = exports.injectContextToHeaders = exports.runWithParentSpanRef = exports.createContextWithParentSpanRef = exports.isParentSpanRef = exports.A365_MESSAGE_SCHEMA_VERSION = exports.InferenceOperationType = exports.InvocationRole = exports.Modality = exports.FinishReason = exports.MessageRole = exports.OpenTelemetryConstants = exports.OutputScope = exports.InferenceScope = exports.ExecuteToolScope = exports.InvokeAgentScope = exports.OpenTelemetryScope = exports.ResolvedExporterOptions = exports.Agent365Exporter = exports.A365_ENV_VARS = exports.A365Configuration = void 0;
+var index_js_1 = require("./configuration/index.js");
+Object.defineProperty(exports, "A365Configuration", { enumerable: true, get: function () { return index_js_1.A365Configuration; } });
+Object.defineProperty(exports, "A365_ENV_VARS", { enumerable: true, get: function () { return index_js_1.A365_ENV_VARS; } });
+var index_js_2 = require("./exporter/index.js");
+Object.defineProperty(exports, "Agent365Exporter", { enumerable: true, get: function () { return index_js_2.Agent365Exporter; } });
+var index_js_3 = require("./exporter/index.js");
+Object.defineProperty(exports, "ResolvedExporterOptions", { enumerable: true, get: function () { return index_js_3.ResolvedExporterOptions; } });
+// ── Scopes (manual telemetry API) ───────────────────────────────────────────
+var index_js_4 = require("./scopes/index.js");
+Object.defineProperty(exports, "OpenTelemetryScope", { enumerable: true, get: function () { return index_js_4.OpenTelemetryScope; } });
+Object.defineProperty(exports, "InvokeAgentScope", { enumerable: true, get: function () { return index_js_4.InvokeAgentScope; } });
+Object.defineProperty(exports, "ExecuteToolScope", { enumerable: true, get: function () { return index_js_4.ExecuteToolScope; } });
+Object.defineProperty(exports, "InferenceScope", { enumerable: true, get: function () { return index_js_4.InferenceScope; } });
+Object.defineProperty(exports, "OutputScope", { enumerable: true, get: function () { return index_js_4.OutputScope; } });
+// ── Constants ───────────────────────────────────────────────────────────────
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "OpenTelemetryConstants", { enumerable: true, get: function () { return constants_js_1.OpenTelemetryConstants; } });
+// ── Contracts (types & enums) ───────────────────────────────────────────────
+var contracts_js_1 = require("./contracts.js");
+Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function () { return contracts_js_1.MessageRole; } });
+Object.defineProperty(exports, "FinishReason", { enumerable: true, get: function () { return contracts_js_1.FinishReason; } });
+Object.defineProperty(exports, "Modality", { enumerable: true, get: function () { return contracts_js_1.Modality; } });
+Object.defineProperty(exports, "InvocationRole", { enumerable: true, get: function () { return contracts_js_1.InvocationRole; } });
+Object.defineProperty(exports, "InferenceOperationType", { enumerable: true, get: function () { return contracts_js_1.InferenceOperationType; } });
+Object.defineProperty(exports, "A365_MESSAGE_SCHEMA_VERSION", { enumerable: true, get: function () { return contracts_js_1.A365_MESSAGE_SCHEMA_VERSION; } });
+// ── Context propagation ─────────────────────────────────────────────────────
+var context_js_1 = require("./context.js");
+Object.defineProperty(exports, "isParentSpanRef", { enumerable: true, get: function () { return context_js_1.isParentSpanRef; } });
+Object.defineProperty(exports, "createContextWithParentSpanRef", { enumerable: true, get: function () { return context_js_1.createContextWithParentSpanRef; } });
+Object.defineProperty(exports, "runWithParentSpanRef", { enumerable: true, get: function () { return context_js_1.runWithParentSpanRef; } });
+Object.defineProperty(exports, "injectContextToHeaders", { enumerable: true, get: function () { return context_js_1.injectContextToHeaders; } });
+Object.defineProperty(exports, "extractContextFromHeaders", { enumerable: true, get: function () { return context_js_1.extractContextFromHeaders; } });
+Object.defineProperty(exports, "runWithExtractedTraceContext", { enumerable: true, get: function () { return context_js_1.runWithExtractedTraceContext; } });
+// ── Middleware (BaggageBuilder) ──────────────────────────────────────────────
+var index_js_5 = require("./middleware/index.js");
+Object.defineProperty(exports, "BaggageBuilder", { enumerable: true, get: function () { return index_js_5.BaggageBuilder; } });
+Object.defineProperty(exports, "BaggageScope", { enumerable: true, get: function () { return index_js_5.BaggageScope; } });
+// ── Processors ──────────────────────────────────────────────────────────────
+var index_js_6 = require("./processors/index.js");
+Object.defineProperty(exports, "A365SpanProcessor", { enumerable: true, get: function () { return index_js_6.A365SpanProcessor; } });
+Object.defineProperty(exports, "PerRequestSpanProcessor", { enumerable: true, get: function () { return index_js_6.PerRequestSpanProcessor; } });
+Object.defineProperty(exports, "GENERIC_ATTRIBUTES", { enumerable: true, get: function () { return index_js_6.GENERIC_ATTRIBUTES; } });
+Object.defineProperty(exports, "INVOKE_AGENT_ATTRIBUTES", { enumerable: true, get: function () { return index_js_6.INVOKE_AGENT_ATTRIBUTES; } });
+// ── Token context ───────────────────────────────────────────────────────────
+var tokenContext_js_1 = require("./context/tokenContext.js");
+Object.defineProperty(exports, "runWithExportToken", { enumerable: true, get: function () { return tokenContext_js_1.runWithExportToken; } });
+Object.defineProperty(exports, "updateExportToken", { enumerable: true, get: function () { return tokenContext_js_1.updateExportToken; } });
+Object.defineProperty(exports, "getExportToken", { enumerable: true, get: function () { return tokenContext_js_1.getExportToken; } });
+// ── Hosting utilities ───────────────────────────────────────────────────────
+var index_js_7 = require("./hosting/index.js");
+Object.defineProperty(exports, "BaggageBuilderUtils", { enumerable: true, get: function () { return index_js_7.BaggageBuilderUtils; } });
+Object.defineProperty(exports, "ScopeUtils", { enumerable: true, get: function () { return index_js_7.ScopeUtils; } });
+Object.defineProperty(exports, "getCallerBaggagePairs", { enumerable: true, get: function () { return index_js_7.getCallerBaggagePairs; } });
+Object.defineProperty(exports, "getTargetAgentBaggagePairs", { enumerable: true, get: function () { return index_js_7.getTargetAgentBaggagePairs; } });
+Object.defineProperty(exports, "getTenantIdPair", { enumerable: true, get: function () { return index_js_7.getTenantIdPair; } });
+Object.defineProperty(exports, "getChannelBaggagePairs", { enumerable: true, get: function () { return index_js_7.getChannelBaggagePairs; } });
+Object.defineProperty(exports, "getConversationIdAndItemLinkPairs", { enumerable: true, get: function () { return index_js_7.getConversationIdAndItemLinkPairs; } });
+Object.defineProperty(exports, "resolveEmbodiedAgentIds", { enumerable: true, get: function () { return index_js_7.resolveEmbodiedAgentIds; } });
+Object.defineProperty(exports, "BaggageMiddleware", { enumerable: true, get: function () { return index_js_7.BaggageMiddleware; } });
+Object.defineProperty(exports, "OutputLoggingMiddleware", { enumerable: true, get: function () { return index_js_7.OutputLoggingMiddleware; } });
+Object.defineProperty(exports, "A365_PARENT_SPAN_KEY", { enumerable: true, get: function () { return index_js_7.A365_PARENT_SPAN_KEY; } });
+Object.defineProperty(exports, "A365_AUTH_TOKEN_KEY", { enumerable: true, get: function () { return index_js_7.A365_AUTH_TOKEN_KEY; } });
+Object.defineProperty(exports, "ObservabilityHostingManager", { enumerable: true, get: function () { return index_js_7.ObservabilityHostingManager; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/a365/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,qDAA4E;AAAnE,6GAAA,iBAAiB,OAAA;AAAE,yGAAA,aAAa,OAAA;AAQzC,gDAAuD;AAA9C,4GAAA,gBAAgB,OAAA;AAEzB,gDAA8D;AAArD,mHAAA,uBAAuB,OAAA;AAEhC,+EAA+E;AAC/E,8CAM2B;AALzB,8GAAA,kBAAkB,OAAA;AAClB,4GAAA,gBAAgB,OAAA;AAChB,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,uGAAA,WAAW,OAAA;AAGb,+EAA+E;AAC/E,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA;AAE/B,+EAA+E;AAC/E,+CAOwB;AANtB,2GAAA,WAAW,OAAA;AACX,4GAAA,YAAY,OAAA;AACZ,wGAAA,QAAQ,OAAA;AACR,8GAAA,cAAc,OAAA;AACd,sHAAA,sBAAsB,OAAA;AACtB,2HAAA,2BAA2B,OAAA;AA+B7B,+EAA+E;AAC/E,2CAOsB;AANpB,6GAAA,eAAe,OAAA;AACf,4HAAA,8BAA8B,OAAA;AAC9B,kHAAA,oBAAoB,OAAA;AACpB,oHAAA,sBAAsB,OAAA;AACtB,uHAAA,yBAAyB,OAAA;AACzB,0HAAA,4BAA4B,OAAA;AAI9B,gFAAgF;AAChF,kDAAqE;AAA5D,0GAAA,cAAc,OAAA;AAAE,wGAAA,YAAY,OAAA;AAErC,+EAA+E;AAC/E,kDAK+B;AAJ7B,6GAAA,iBAAiB,OAAA;AACjB,mHAAA,uBAAuB,OAAA;AACvB,8GAAA,kBAAkB,OAAA;AAClB,mHAAA,uBAAuB,OAAA;AAIzB,+EAA+E;AAC/E,6DAAkG;AAAzF,qHAAA,kBAAkB,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,iHAAA,cAAc,OAAA;AAE9D,+EAA+E;AAC/E,+CAc4B;AAb1B,+GAAA,mBAAmB,OAAA;AACnB,sGAAA,UAAU,OAAA;AACV,iHAAA,qBAAqB,OAAA;AACrB,sHAAA,0BAA0B,OAAA;AAC1B,2GAAA,eAAe,OAAA;AACf,kHAAA,sBAAsB,OAAA;AACtB,6HAAA,iCAAiC,OAAA;AACjC,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,mHAAA,uBAAuB,OAAA;AACvB,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AACnB,uHAAA,2BAA2B,OAAA"}

package/dist/commonjs/a365/message-utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Utilities for normalizing and serializing gen-ai messages.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/message-utils.ts
+ */
+import type { ChatMessage, OutputMessage, InputMessages, OutputMessages, InputMessagesParam, OutputMessagesParam } from "./contracts.js";
+/**
+ * Type guard that returns `true` when the input is a versioned wrapper
+ * object (`InputMessages` or `OutputMessages`).
+ */
+export declare function isWrappedMessages(input: InputMessagesParam | OutputMessagesParam): input is InputMessages | OutputMessages;
+/** Converts plain input strings into OTEL input messages. */
+export declare function toInputMessages(messages: string[]): ChatMessage[];
+/** Converts plain output strings into OTEL output messages. */
+export declare function toOutputMessages(messages: string[]): OutputMessage[];
+/**
+ * Normalizes an `InputMessagesParam` to a versioned `InputMessages` wrapper.
+ * - `string` / `string[]` → converted to `ChatMessage[]` and wrapped
+ * - `InputMessages` → returned as-is
+ */
+export declare function normalizeInputMessages(param: InputMessagesParam): InputMessages;
+/**
+ * Normalizes an `OutputMessagesParam` to a versioned `OutputMessages` wrapper.
+ * - `string` / `string[]` → converted to `OutputMessage[]` and wrapped
+ * - `OutputMessages` → returned as-is
+ */
+export declare function normalizeOutputMessages(param: OutputMessagesParam): OutputMessages;
+/**
+ * Serializes a versioned message wrapper to JSON.
+ *
+ * The try/catch ensures telemetry recording is non-throwing even when
+ * message parts contain non-JSON-serializable values.
+ */
+export declare function serializeMessages(wrapper: InputMessages | OutputMessages): string;
+/**
+ * Ensures the value is always a JSON-parseable string.
+ * - Objects are serialized via JSON.stringify.
+ * - Strings that are already valid JSON objects/arrays are passed through.
+ * - All other strings are wrapped: `{ [key]: value }`.
+ */
+export declare function safeSerializeToJson(value: Record<string, unknown> | string, key: string): string;
+//# sourceMappingURL=message-utils.d.ts.map

package/dist/commonjs/a365/message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../src/a365/message-utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAGxB;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAC9C,KAAK,IAAI,aAAa,GAAG,cAAc,CAQzC;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAKjE;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAKpE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAMlF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,GAAG,MAAM,CAmBjF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBhG"}

package/dist/commonjs/a365/message-utils.js

@@ -0,0 +1,116 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWrappedMessages = isWrappedMessages;
+exports.toInputMessages = toInputMessages;
+exports.toOutputMessages = toOutputMessages;
+exports.normalizeInputMessages = normalizeInputMessages;
+exports.normalizeOutputMessages = normalizeOutputMessages;
+exports.serializeMessages = serializeMessages;
+exports.safeSerializeToJson = safeSerializeToJson;
+const contracts_js_1 = require("./contracts.js");
+/**
+ * Type guard that returns `true` when the input is a versioned wrapper
+ * object (`InputMessages` or `OutputMessages`).
+ */
+function isWrappedMessages(input) {
+    return (!Array.isArray(input) &&
+        typeof input === "object" &&
+        input !== null &&
+        "version" in input &&
+        "messages" in input);
+}
+/** Converts plain input strings into OTEL input messages. */
+function toInputMessages(messages) {
+    return messages.map((content) => ({
+        role: contracts_js_1.MessageRole.USER,
+        parts: [{ type: "text", content }],
+    }));
+}
+/** Converts plain output strings into OTEL output messages. */
+function toOutputMessages(messages) {
+    return messages.map((content) => ({
+        role: contracts_js_1.MessageRole.ASSISTANT,
+        parts: [{ type: "text", content }],
+    }));
+}
+/**
+ * Normalizes an `InputMessagesParam` to a versioned `InputMessages` wrapper.
+ * - `string` / `string[]` → converted to `ChatMessage[]` and wrapped
+ * - `InputMessages` → returned as-is
+ */
+function normalizeInputMessages(param) {
+    if (typeof param === "string" || Array.isArray(param)) {
+        const arr = typeof param === "string" ? [param] : param;
+        return { version: contracts_js_1.A365_MESSAGE_SCHEMA_VERSION, messages: toInputMessages(arr) };
+    }
+    return param;
+}
+/**
+ * Normalizes an `OutputMessagesParam` to a versioned `OutputMessages` wrapper.
+ * - `string` / `string[]` → converted to `OutputMessage[]` and wrapped
+ * - `OutputMessages` → returned as-is
+ */
+function normalizeOutputMessages(param) {
+    if (typeof param === "string" || Array.isArray(param)) {
+        const arr = typeof param === "string" ? [param] : param;
+        return { version: contracts_js_1.A365_MESSAGE_SCHEMA_VERSION, messages: toOutputMessages(arr) };
+    }
+    return param;
+}
+/**
+ * Serializes a versioned message wrapper to JSON.
+ *
+ * The try/catch ensures telemetry recording is non-throwing even when
+ * message parts contain non-JSON-serializable values.
+ */
+function serializeMessages(wrapper) {
+    try {
+        return JSON.stringify(wrapper);
+    }
+    catch {
+        return JSON.stringify({
+            version: contracts_js_1.A365_MESSAGE_SCHEMA_VERSION,
+            messages: [
+                {
+                    role: contracts_js_1.MessageRole.SYSTEM,
+                    parts: [
+                        {
+                            type: "text",
+                            content: `[serialization failed: ${wrapper.messages.length} ${wrapper.messages.length === 1 ? "message" : "messages"}]`,
+                        },
+                    ],
+                },
+            ],
+        });
+    }
+}
+/**
+ * Ensures the value is always a JSON-parseable string.
+ * - Objects are serialized via JSON.stringify.
+ * - Strings that are already valid JSON objects/arrays are passed through.
+ * - All other strings are wrapped: `{ [key]: value }`.
+ */
+function safeSerializeToJson(value, key) {
+    if (typeof value === "object" && value !== null) {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return JSON.stringify({ error: "serialization failed" });
+        }
+    }
+    const str = value;
+    try {
+        const parsed = JSON.parse(str);
+        if (parsed !== null && typeof parsed === "object") {
+            return str;
+        }
+    }
+    catch {
+        // not valid JSON — fall through to wrap
+    }
+    return JSON.stringify({ [key]: str });
+}
+//# sourceMappingURL=message-utils.js.map

package/dist/commonjs/a365/message-utils.js.map

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

package/dist/commonjs/a365/middleware/BaggageBuilder.d.ts

@@ -0,0 +1,112 @@
+import type { Context } from "@opentelemetry/api";
+/**
+ * Fluent builder for setting OpenTelemetry baggage values.
+ *
+ * @example
+ * ```typescript
+ * const scope = new BaggageBuilder()
+ *   .tenantId("tenant-123")
+ *   .agentId("agent-456")
+ *   .build();
+ *
+ * scope.run(() => {
+ *   // Baggage is active in this context
+ * });
+ * ```
+ */
+export declare class BaggageBuilder {
+    private pairs;
+    /** Set the operation source baggage value (e.g., ATG, ACF). */
+    operationSource(value: string | null | undefined): BaggageBuilder;
+    /** Set the tenant ID baggage value. */
+    tenantId(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent ID baggage value. */
+    agentId(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent AUID baggage value. */
+    agentAuid(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent email baggage value. */
+    agentEmail(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent blueprint ID baggage value. */
+    agentBlueprintId(value: string | null | undefined): BaggageBuilder;
+    /** Set the session ID baggage value. */
+    sessionId(value: string): BaggageBuilder;
+    /** Set the user ID baggage value. */
+    userId(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent name baggage value. */
+    agentName(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent description baggage value. */
+    agentDescription(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent platform ID baggage value. */
+    agentPlatformId(value: string | null | undefined): BaggageBuilder;
+    /** Set the agent version baggage value. */
+    agentVersion(value: string | null | undefined): BaggageBuilder;
+    /** Set the session description baggage value. */
+    sessionDescription(value: string | null | undefined): BaggageBuilder;
+    /** Set the user name baggage value. */
+    userName(value: string | null | undefined): BaggageBuilder;
+    /** Set the user email baggage value. */
+    userEmail(value: string | null | undefined): BaggageBuilder;
+    /** Set the caller client IP baggage value. */
+    callerClientIp(value: string | null | undefined): BaggageBuilder;
+    /** Set the caller agent platform ID baggage value. */
+    callerAgentPlatformId(value: string | null | undefined): BaggageBuilder;
+    /** Set the conversation ID baggage value. */
+    conversationId(value: string | null | undefined): BaggageBuilder;
+    /** Set the conversation item link baggage value. */
+    conversationItemLink(value: string | null | undefined): BaggageBuilder;
+    /** Set the channel name (e.g., Teams, Slack). */
+    channelName(value: string | null | undefined): BaggageBuilder;
+    /** Set the channel link/URL. */
+    channelLink(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Sets the invoke agent server address and port baggage values.
+     * @param address The server address (hostname) of the target agent service.
+     * @param port Optional server port. Only recorded when different from 443.
+     */
+    invokeAgentServer(address: string | null | undefined, port?: number): BaggageBuilder;
+    /**
+     * Set multiple baggage pairs from a dictionary or iterable.
+     * @param pairs Dictionary or iterable of key-value pairs
+     */
+    setPairs(pairs: Record<string, any> | Iterable<[string, any]> | null | undefined): BaggageBuilder;
+    /**
+     * Apply the collected baggage to the current context.
+     * @returns A BaggageScope that can run callbacks under the baggage context
+     */
+    build(): BaggageScope;
+    /**
+     * Add a baggage key/value if the value is not null or whitespace.
+     */
+    private set;
+    /**
+     * Convenience method to begin a request baggage scope with common fields.
+     * @param tenantId The tenant ID
+     * @param agentId The agent ID
+     * @returns A BaggageScope with tenant and agent ID set
+     */
+    static setRequestContext(tenantId?: string | null, agentId?: string | null): BaggageScope;
+}
+/**
+ * Context manager for baggage scope.
+ *
+ * Manages the lifecycle of baggage values, setting them in the OTel context
+ * and restoring the previous context when the scope ends.
+ */
+export declare class BaggageScope {
+    /** @internal Exposed for testing. */
+    readonly contextWithBaggage: Context;
+    constructor(pairs: Map<string, string>);
+    /**
+     * Execute a synchronous function under this baggage scope.
+     * Automatically restores previous context afterward.
+     */
+    run<T>(fn: () => T): T;
+    /**
+     * Dispose is a no-op because OpenTelemetry JS automatically restores
+     * the previous context after `context.with()` completes.
+     */
+    [Symbol.dispose](): void;
+    /** Manual cleanup alternative if caller isn't using `using`. */
+    dispose(): void;
+}
+//# sourceMappingURL=BaggageBuilder.d.ts.map

package/dist/commonjs/a365/middleware/BaggageBuilder.d.ts.map

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

package/dist/commonjs/a365/middleware/BaggageBuilder.js

@@ -0,0 +1,248 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaggageScope = exports.BaggageBuilder = void 0;
+/**
+ * Per-request baggage builder for OpenTelemetry context propagation.
+ *
+ * Provides a fluent API for setting baggage values that will be propagated
+ * in the OpenTelemetry context and stamped onto spans by the SpanProcessor.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/middleware/BaggageBuilder.ts
+ */
+const api_1 = require("@opentelemetry/api");
+const constants_js_1 = require("../constants.js");
+/**
+ * Fluent builder for setting OpenTelemetry baggage values.
+ *
+ * @example
+ * ```typescript
+ * const scope = new BaggageBuilder()
+ *   .tenantId("tenant-123")
+ *   .agentId("agent-456")
+ *   .build();
+ *
+ * scope.run(() => {
+ *   // Baggage is active in this context
+ * });
+ * ```
+ */
+class BaggageBuilder {
+    pairs = new Map();
+    /** Set the operation source baggage value (e.g., ATG, ACF). */
+    operationSource(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.SERVICE_NAME_KEY, value);
+        return this;
+    }
+    /** Set the tenant ID baggage value. */
+    tenantId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.TENANT_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent ID baggage value. */
+    agentId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent AUID baggage value. */
+    agentAuid(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, value);
+        return this;
+    }
+    /** Set the agent email baggage value. */
+    agentEmail(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_EMAIL_KEY, value);
+        return this;
+    }
+    /** Set the agent blueprint ID baggage value. */
+    agentBlueprintId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, value);
+        return this;
+    }
+    /** Set the session ID baggage value. */
+    sessionId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.SESSION_ID_KEY, value);
+        return this;
+    }
+    /** Set the user ID baggage value. */
+    userId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.USER_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent name baggage value. */
+    agentName(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, value);
+        return this;
+    }
+    /** Set the agent description baggage value. */
+    agentDescription(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /** Set the agent platform ID baggage value. */
+    agentPlatformId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_PLATFORM_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent version baggage value. */
+    agentVersion(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_AGENT_VERSION_KEY, value);
+        return this;
+    }
+    /** Set the session description baggage value. */
+    sessionDescription(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.SESSION_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /** Set the user name baggage value. */
+    userName(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.USER_NAME_KEY, value);
+        return this;
+    }
+    /** Set the user email baggage value. */
+    userEmail(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.USER_EMAIL_KEY, value);
+        return this;
+    }
+    /** Set the caller client IP baggage value. */
+    callerClientIp(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_CALLER_CLIENT_IP_KEY, value);
+        return this;
+    }
+    /** Set the caller agent platform ID baggage value. */
+    callerAgentPlatformId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY, value);
+        return this;
+    }
+    /** Set the conversation ID baggage value. */
+    conversationId(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, value);
+        return this;
+    }
+    /** Set the conversation item link baggage value. */
+    conversationItemLink(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY, value);
+        return this;
+    }
+    /** Set the channel name (e.g., Teams, Slack). */
+    channelName(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.CHANNEL_NAME_KEY, value);
+        return this;
+    }
+    /** Set the channel link/URL. */
+    channelLink(value) {
+        this.set(constants_js_1.OpenTelemetryConstants.CHANNEL_LINK_KEY, value);
+        return this;
+    }
+    /**
+     * Sets the invoke agent server address and port baggage values.
+     * @param address The server address (hostname) of the target agent service.
+     * @param port Optional server port. Only recorded when different from 443.
+     */
+    invokeAgentServer(address, port) {
+        this.set(constants_js_1.OpenTelemetryConstants.SERVER_ADDRESS_KEY, address);
+        if (port !== undefined && port !== 443) {
+            this.set(constants_js_1.OpenTelemetryConstants.SERVER_PORT_KEY, port.toString());
+        }
+        else {
+            this.pairs.delete(constants_js_1.OpenTelemetryConstants.SERVER_PORT_KEY);
+        }
+        return this;
+    }
+    /**
+     * Set multiple baggage pairs from a dictionary or iterable.
+     * @param pairs Dictionary or iterable of key-value pairs
+     */
+    setPairs(pairs) {
+        if (!pairs) {
+            return this;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let entries;
+        if (Symbol.iterator in Object(pairs)) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            entries = pairs;
+        }
+        else {
+            entries = Object.entries(pairs);
+        }
+        for (const [key, value] of entries) {
+            if (value !== null && value !== undefined) {
+                this.set(key, String(value));
+            }
+        }
+        return this;
+    }
+    /**
+     * Apply the collected baggage to the current context.
+     * @returns A BaggageScope that can run callbacks under the baggage context
+     */
+    build() {
+        return new BaggageScope(this.pairs);
+    }
+    /**
+     * Add a baggage key/value if the value is not null or whitespace.
+     */
+    set(key, value) {
+        if (value !== null && value !== undefined) {
+            const trimmed = value.trim();
+            if (trimmed) {
+                this.pairs.set(key, trimmed);
+            }
+        }
+    }
+    /**
+     * Convenience method to begin a request baggage scope with common fields.
+     * @param tenantId The tenant ID
+     * @param agentId The agent ID
+     * @returns A BaggageScope with tenant and agent ID set
+     */
+    static setRequestContext(tenantId, agentId) {
+        return new BaggageBuilder().tenantId(tenantId).agentId(agentId).build();
+    }
+}
+exports.BaggageBuilder = BaggageBuilder;
+/**
+ * Context manager for baggage scope.
+ *
+ * Manages the lifecycle of baggage values, setting them in the OTel context
+ * and restoring the previous context when the scope ends.
+ */
+class BaggageScope {
+    /** @internal Exposed for testing. */
+    contextWithBaggage;
+    constructor(pairs) {
+        // 1. Start from current active context
+        const currentCtx = api_1.context.active();
+        // 2. Build merged baggage
+        let bag = api_1.propagation.getBaggage(currentCtx) ?? api_1.propagation.createBaggage({});
+        for (const [key, value] of pairs.entries()) {
+            if (value && value.trim()) {
+                bag = bag.setEntry(key, { value });
+            }
+        }
+        // 3. Create a new context that carries that baggage
+        this.contextWithBaggage = api_1.propagation.setBaggage(currentCtx, bag);
+    }
+    /**
+     * Execute a synchronous function under this baggage scope.
+     * Automatically restores previous context afterward.
+     */
+    run(fn) {
+        return api_1.context.with(this.contextWithBaggage, fn);
+    }
+    /**
+     * Dispose is a no-op because OpenTelemetry JS automatically restores
+     * the previous context after `context.with()` completes.
+     */
+    [Symbol.dispose]() {
+        // Nothing to detach manually; context restoration happens automatically.
+    }
+    /** Manual cleanup alternative if caller isn't using `using`. */
+    dispose() {
+        this[Symbol.dispose]();
+    }
+}
+exports.BaggageScope = BaggageScope;
+//# sourceMappingURL=BaggageBuilder.js.map