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

package/dist/esm/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/esm/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/esm/a365/index.js

@@ -0,0 +1,22 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { A365Configuration, A365_ENV_VARS } from "./configuration/index.js";
+export { Agent365Exporter } from "./exporter/index.js";
+export { ResolvedExporterOptions } from "./exporter/index.js";
+// ── Scopes (manual telemetry API) ───────────────────────────────────────────
+export { OpenTelemetryScope, InvokeAgentScope, ExecuteToolScope, InferenceScope, OutputScope, } from "./scopes/index.js";
+// ── Constants ───────────────────────────────────────────────────────────────
+export { OpenTelemetryConstants } from "./constants.js";
+// ── Contracts (types & enums) ───────────────────────────────────────────────
+export { MessageRole, FinishReason, Modality, InvocationRole, InferenceOperationType, A365_MESSAGE_SCHEMA_VERSION, } from "./contracts.js";
+// ── Context propagation ─────────────────────────────────────────────────────
+export { isParentSpanRef, createContextWithParentSpanRef, runWithParentSpanRef, injectContextToHeaders, extractContextFromHeaders, runWithExtractedTraceContext, } from "./context.js";
+// ── Middleware (BaggageBuilder) ──────────────────────────────────────────────
+export { BaggageBuilder, BaggageScope } from "./middleware/index.js";
+// ── Processors ──────────────────────────────────────────────────────────────
+export { A365SpanProcessor, PerRequestSpanProcessor, GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES, } from "./processors/index.js";
+// ── Token context ───────────────────────────────────────────────────────────
+export { runWithExportToken, updateExportToken, getExportToken } from "./context/tokenContext.js";
+// ── Hosting utilities ───────────────────────────────────────────────────────
+export { BaggageBuilderUtils, ScopeUtils, getCallerBaggagePairs, getTargetAgentBaggagePairs, getTenantIdPair, getChannelBaggagePairs, getConversationIdAndItemLinkPairs, resolveEmbodiedAgentIds, BaggageMiddleware, OutputLoggingMiddleware, A365_PARENT_SPAN_KEY, A365_AUTH_TOKEN_KEY, ObservabilityHostingManager, } from "./hosting/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQ5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,+EAA+E;AAC/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AA8BxB,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAGtB,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErE,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElG,+EAA+E;AAC/E,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"}

package/dist/esm/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/esm/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/esm/a365/message-utils.js

@@ -0,0 +1,107 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { MessageRole, A365_MESSAGE_SCHEMA_VERSION } from "./contracts.js";
+/**
+ * Type guard that returns `true` when the input is a versioned wrapper
+ * object (`InputMessages` or `OutputMessages`).
+ */
+export 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. */
+export function toInputMessages(messages) {
+    return messages.map((content) => ({
+        role: MessageRole.USER,
+        parts: [{ type: "text", content }],
+    }));
+}
+/** Converts plain output strings into OTEL output messages. */
+export function toOutputMessages(messages) {
+    return messages.map((content) => ({
+        role: 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
+ */
+export function normalizeInputMessages(param) {
+    if (typeof param === "string" || Array.isArray(param)) {
+        const arr = typeof param === "string" ? [param] : param;
+        return { version: 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
+ */
+export function normalizeOutputMessages(param) {
+    if (typeof param === "string" || Array.isArray(param)) {
+        const arr = typeof param === "string" ? [param] : param;
+        return { version: 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.
+ */
+export function serializeMessages(wrapper) {
+    try {
+        return JSON.stringify(wrapper);
+    }
+    catch {
+        return JSON.stringify({
+            version: A365_MESSAGE_SCHEMA_VERSION,
+            messages: [
+                {
+                    role: 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 }`.
+ */
+export 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/esm/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/esm/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/esm/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/esm/a365/middleware/BaggageBuilder.js

@@ -0,0 +1,243 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * 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
+ */
+import { propagation, context as otelContext } from "@opentelemetry/api";
+import { OpenTelemetryConstants } from "../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
+ * });
+ * ```
+ */
+export class BaggageBuilder {
+    pairs = new Map();
+    /** Set the operation source baggage value (e.g., ATG, ACF). */
+    operationSource(value) {
+        this.set(OpenTelemetryConstants.SERVICE_NAME_KEY, value);
+        return this;
+    }
+    /** Set the tenant ID baggage value. */
+    tenantId(value) {
+        this.set(OpenTelemetryConstants.TENANT_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent ID baggage value. */
+    agentId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent AUID baggage value. */
+    agentAuid(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, value);
+        return this;
+    }
+    /** Set the agent email baggage value. */
+    agentEmail(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_EMAIL_KEY, value);
+        return this;
+    }
+    /** Set the agent blueprint ID baggage value. */
+    agentBlueprintId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, value);
+        return this;
+    }
+    /** Set the session ID baggage value. */
+    sessionId(value) {
+        this.set(OpenTelemetryConstants.SESSION_ID_KEY, value);
+        return this;
+    }
+    /** Set the user ID baggage value. */
+    userId(value) {
+        this.set(OpenTelemetryConstants.USER_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent name baggage value. */
+    agentName(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, value);
+        return this;
+    }
+    /** Set the agent description baggage value. */
+    agentDescription(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /** Set the agent platform ID baggage value. */
+    agentPlatformId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_PLATFORM_ID_KEY, value);
+        return this;
+    }
+    /** Set the agent version baggage value. */
+    agentVersion(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_VERSION_KEY, value);
+        return this;
+    }
+    /** Set the session description baggage value. */
+    sessionDescription(value) {
+        this.set(OpenTelemetryConstants.SESSION_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /** Set the user name baggage value. */
+    userName(value) {
+        this.set(OpenTelemetryConstants.USER_NAME_KEY, value);
+        return this;
+    }
+    /** Set the user email baggage value. */
+    userEmail(value) {
+        this.set(OpenTelemetryConstants.USER_EMAIL_KEY, value);
+        return this;
+    }
+    /** Set the caller client IP baggage value. */
+    callerClientIp(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CALLER_CLIENT_IP_KEY, value);
+        return this;
+    }
+    /** Set the caller agent platform ID baggage value. */
+    callerAgentPlatformId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY, value);
+        return this;
+    }
+    /** Set the conversation ID baggage value. */
+    conversationId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, value);
+        return this;
+    }
+    /** Set the conversation item link baggage value. */
+    conversationItemLink(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY, value);
+        return this;
+    }
+    /** Set the channel name (e.g., Teams, Slack). */
+    channelName(value) {
+        this.set(OpenTelemetryConstants.CHANNEL_NAME_KEY, value);
+        return this;
+    }
+    /** Set the channel link/URL. */
+    channelLink(value) {
+        this.set(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(OpenTelemetryConstants.SERVER_ADDRESS_KEY, address);
+        if (port !== undefined && port !== 443) {
+            this.set(OpenTelemetryConstants.SERVER_PORT_KEY, port.toString());
+        }
+        else {
+            this.pairs.delete(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();
+    }
+}
+/**
+ * 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 class BaggageScope {
+    /** @internal Exposed for testing. */
+    contextWithBaggage;
+    constructor(pairs) {
+        // 1. Start from current active context
+        const currentCtx = otelContext.active();
+        // 2. Build merged baggage
+        let bag = propagation.getBaggage(currentCtx) ?? 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 = propagation.setBaggage(currentCtx, bag);
+    }
+    /**
+     * Execute a synchronous function under this baggage scope.
+     * Automatically restores previous context afterward.
+     */
+    run(fn) {
+        return otelContext.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]();
+    }
+}
+//# sourceMappingURL=BaggageBuilder.js.map

package/dist/esm/a365/middleware/BaggageBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaggageBuilder.js","sourceRoot":"","sources":["../../../../src/a365/middleware/BaggageBuilder.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IACjB,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE/C,+DAA+D;IAC/D,eAAe,CAAC,KAAgC;QAC9C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,QAAQ,CAAC,KAAgC;QACvC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,KAAgC;QACtC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,SAAS,CAAC,KAAgC;QACxC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yCAAyC;IACzC,UAAU,CAAC,KAAgC;QACzC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,gBAAgB,CAAC,KAAgC;QAC/C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,KAAgC;QACrC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,SAAS,CAAC,KAAgC;QACxC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,gBAAgB,CAAC,KAAgC;QAC/C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,eAAe,CAAC,KAAgC;QAC9C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAC3C,YAAY,CAAC,KAAgC;QAC3C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,kBAAkB,CAAC,KAAgC;QACjD,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,QAAQ,CAAC,KAAgC;QACvC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,SAAS,CAAC,KAAgC;QACxC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8CAA8C;IAC9C,cAAc,CAAC,KAAgC;QAC7C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,qBAAqB,CAAC,KAAgC;QACpD,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,cAAc,CAAC,KAAgC;QAC7C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,oBAAoB,CAAC,KAAgC;QACnD,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,WAAW,CAAC,KAAgC;QAC1C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gCAAgC;IAChC,WAAW,CAAC,KAAgC;QAC1C,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,OAAkC,EAAE,IAAa;QACjE,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,eAAe,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IAEH,QAAQ,CACN,KAAuE;QAEvE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8DAA8D;QAC9D,IAAI,OAAgC,CAAC;QACrC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,8DAA8D;YAC9D,OAAO,GAAG,KAAgC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,GAAW,EAAE,KAAgC;QACvD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAwB,EAAE,OAAuB;QACxE,OAAO,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;IAC1E,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACvB,qCAAqC;IAC5B,kBAAkB,CAAU;IAErC,YAAY,KAA0B;QACpC,uCAAuC;QACvC,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QAExC,0BAA0B;QAC1B,IAAI,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC1B,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC,kBAAkB,GAAG,WAAW,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,GAAG,CAAI,EAAW;QAChB,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,yEAAyE;IAC3E,CAAC;IAED,gEAAgE;IAChE,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export { BaggageBuilder, BaggageScope } from "./BaggageBuilder.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a365/middleware/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { BaggageBuilder, BaggageScope } from "./BaggageBuilder.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/a365/middleware/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/a365/processors/A365SpanProcessor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Span processor that propagates baggage key/value pairs to span attributes.
+ *
+ * This processor copies baggage entries onto spans based on the operation type.
+ * For `invoke_agent` operations, it applies both generic and invoke-agent-specific attributes.
+ * For other operations, it applies only generic attributes.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/processors/SpanProcessor.ts
+ */
+import type { Context, Span } from "@opentelemetry/api";
+import type { SpanProcessor as BaseSpanProcessor, ReadableSpan } from "@opentelemetry/sdk-trace-base";
+/**
+ * Copies relevant baggage entries to span attributes on span start.
+ *
+ * This is the "automatic" counterpart to the manual scope API — it ensures
+ * every span in the pipeline gets agent identity attributes from baggage
+ * without explicitly creating scopes.
+ */
+export declare class A365SpanProcessor implements BaseSpanProcessor {
+    /**
+     * Called when a span is started.
+     * Copies relevant baggage entries to span attributes.
+     */
+    onStart(span: Span, parentContext?: Context): void;
+    /** Called when a span is ended. */
+    onEnd(_span: ReadableSpan): void;
+    /** Shutdown the processor. */
+    shutdown(): Promise<void>;
+    /** Force flush the processor. */
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=A365SpanProcessor.d.ts.map

package/dist/esm/a365/processors/A365SpanProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"A365SpanProcessor.d.ts","sourceRoot":"","sources":["../../../../src/a365/processors/A365SpanProcessor.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EACV,aAAa,IAAI,iBAAiB,EAClC,YAAY,EACb,MAAM,+BAA+B,CAAC;AAIvC;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAyFlD,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIhC,8BAA8B;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,iCAAiC;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}