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

package/dist/esm/a365/exporter/Agent365Exporter.js

@@ -0,0 +1,216 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ExportResultCode } from "@opentelemetry/core";
+import { ResolvedExporterOptions } from "./Agent365ExporterOptions.js";
+import { partitionByIdentity, parseIdentityKey, hexTraceId, hexSpanId, kindName, statusName, resolveAgent365Endpoint, truncateSpan, } from "./utils.js";
+import { Logger } from "../../shared/logging/index.js";
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Agent365 span exporter.
+ *
+ * Implements `SpanExporter` from `@opentelemetry/sdk-trace-base`.
+ * Partitions spans by (tenantId, agentId), builds OTLP-like JSON payloads,
+ * and POSTs them to the Agent365 observability service with Bearer auth.
+ */
+export class Agent365Exporter {
+    closed = false;
+    options;
+    logger = Logger.getInstance();
+    constructor(options) {
+        this.options = new ResolvedExporterOptions(options);
+    }
+    async export(spans, resultCallback) {
+        if (this.closed) {
+            resultCallback({ code: ExportResultCode.FAILED });
+            return;
+        }
+        try {
+            this.logger.info(`[Agent365Exporter] Exporting ${spans.length} spans`);
+            const groups = partitionByIdentity(spans);
+            if (groups.size === 0) {
+                resultCallback({ code: ExportResultCode.SUCCESS });
+                return;
+            }
+            let anyFailure = false;
+            const promises = [];
+            for (const [identityKey, groupSpans] of groups) {
+                const promise = this.exportGroup(identityKey, groupSpans).catch((err) => {
+                    anyFailure = true;
+                    this.logger.error(`[Agent365Exporter] Error exporting group ${identityKey}:`, err);
+                });
+                promises.push(promise);
+            }
+            await Promise.all(promises);
+            resultCallback({
+                code: anyFailure ? ExportResultCode.FAILED : ExportResultCode.SUCCESS,
+            });
+        }
+        catch (err) {
+            this.logger.error("[Agent365Exporter] Export failed:", err);
+            resultCallback({ code: ExportResultCode.FAILED });
+        }
+    }
+    async exportGroup(identityKey, spans) {
+        const { tenantId, agentId } = parseIdentityKey(identityKey);
+        const payload = this.buildExportRequest(spans);
+        const body = JSON.stringify(payload);
+        const endpointPath = this.options.useS2SEndpoint
+            ? `/observabilityService/tenants/${encodeURIComponent(tenantId)}/agents/${encodeURIComponent(agentId)}/traces`
+            : `/observability/tenants/${encodeURIComponent(tenantId)}/agents/${encodeURIComponent(agentId)}/traces`;
+        const baseUrl = this.options.domainOverride ?? resolveAgent365Endpoint(this.options.clusterCategory);
+        const url = `${baseUrl}${endpointPath}?api-version=1`;
+        const headers = {
+            "content-type": "application/json",
+            "x-ms-tenant-id": tenantId,
+        };
+        // Resolve token
+        const token = await this.resolveToken(agentId, tenantId);
+        if (!token) {
+            this.logger.warn(`[Agent365Exporter] Skipping export for ${tenantId}/${agentId}: no token available`);
+            return;
+        }
+        headers["authorization"] = `Bearer ${token}`;
+        const { ok } = await this.postWithRetries(url, body, headers);
+        if (!ok) {
+            throw new Error(`Failed to export spans for ${tenantId}/${agentId}`);
+        }
+    }
+    async resolveToken(agentId, tenantId) {
+        if (!this.options.tokenResolver)
+            return null;
+        const result = this.options.tokenResolver(agentId, tenantId);
+        return result instanceof Promise ? result : result;
+    }
+    async postWithRetries(url, body, headers) {
+        let lastCorrelationId = "unknown";
+        for (let attempt = 0; attempt <= DEFAULT_MAX_RETRIES; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: AbortSignal.timeout(this.options.httpRequestTimeoutMilliseconds),
+                });
+                const correlationId = response.headers.get("x-ms-correlation-id") ??
+                    response.headers.get("x-correlation-id") ??
+                    "unknown";
+                lastCorrelationId = correlationId;
+                if (response.status >= 200 && response.status < 300) {
+                    return { ok: true, correlationId };
+                }
+                // Retry on transient errors
+                if ([408, 429].includes(response.status) ||
+                    (response.status >= 500 && response.status < 600)) {
+                    if (attempt < DEFAULT_MAX_RETRIES) {
+                        const sleepMs = 200 * (attempt + 1) + Math.floor(Math.random() * 100);
+                        this.logger.warn(`[Agent365Exporter] Transient error ${response.status}, retrying after ${sleepMs}ms`);
+                        await sleep(sleepMs);
+                        continue;
+                    }
+                }
+                this.logger.error(`[Agent365Exporter] Failed with status ${response.status}, correlation: ${correlationId}`);
+                return { ok: false, correlationId };
+            }
+            catch (error) {
+                this.logger.error("[Agent365Exporter] Request error:", error);
+                if (attempt < DEFAULT_MAX_RETRIES) {
+                    await sleep(200 * (attempt + 1));
+                    continue;
+                }
+                return { ok: false, correlationId: lastCorrelationId };
+            }
+        }
+        return { ok: false, correlationId: lastCorrelationId };
+    }
+    buildExportRequest(spans) {
+        const scopeMap = new Map();
+        for (const sp of spans) {
+            const scope = sp.instrumentationScope;
+            const scopeKey = `${scope?.name ?? "unknown"}:${scope?.version ?? ""}`;
+            let existing = scopeMap.get(scopeKey);
+            if (!existing) {
+                existing = [];
+                scopeMap.set(scopeKey, existing);
+            }
+            existing.push(truncateSpan(this.mapSpan(sp)));
+        }
+        const scopeSpans = [];
+        for (const [scopeKey, mappedSpans] of scopeMap) {
+            const [name, version] = scopeKey.split(":");
+            scopeSpans.push({
+                scope: { name, version: version || undefined },
+                spans: mappedSpans,
+            });
+        }
+        let resourceAttrs = {};
+        if (spans.length > 0 && spans[0].resource?.attributes) {
+            resourceAttrs = { ...spans[0].resource.attributes };
+        }
+        return {
+            resourceSpans: [
+                {
+                    resource: {
+                        attributes: Object.keys(resourceAttrs).length > 0 ? resourceAttrs : null,
+                    },
+                    scopeSpans,
+                },
+            ],
+        };
+    }
+    mapSpan(sp) {
+        const ctx = sp.spanContext();
+        let parentSpanId;
+        if (sp.parentSpanContext?.spanId && sp.parentSpanContext.spanId !== "0000000000000000") {
+            parentSpanId = hexSpanId(sp.parentSpanContext.spanId);
+        }
+        const attrs = sp.attributes ? { ...sp.attributes } : {};
+        const events = (sp.events ?? []).map((ev) => {
+            const timeNs = Array.isArray(ev.time)
+                ? ev.time[0] * 1_000_000_000 + ev.time[1]
+                : ev.time;
+            const evAttrs = ev.attributes && Object.keys(ev.attributes).length > 0 ? { ...ev.attributes } : null;
+            return { timeUnixNano: timeNs, name: ev.name, attributes: evAttrs };
+        });
+        const links = (sp.links ?? []).map((ln) => {
+            const lnAttrs = ln.attributes && Object.keys(ln.attributes).length > 0 ? { ...ln.attributes } : null;
+            return {
+                traceId: hexTraceId(ln.context.traceId),
+                spanId: hexSpanId(ln.context.spanId),
+                attributes: lnAttrs,
+            };
+        });
+        const status = {
+            code: statusName(sp.status?.code ?? 0),
+            message: sp.status?.message || "",
+        };
+        const startTimeNs = Array.isArray(sp.startTime)
+            ? sp.startTime[0] * 1_000_000_000 + sp.startTime[1]
+            : sp.startTime;
+        const endTimeNs = Array.isArray(sp.endTime)
+            ? sp.endTime[0] * 1_000_000_000 + sp.endTime[1]
+            : sp.endTime;
+        return {
+            traceId: hexTraceId(ctx.traceId),
+            spanId: hexSpanId(ctx.spanId),
+            parentSpanId,
+            name: sp.name,
+            kind: kindName(sp.kind),
+            startTimeUnixNano: startTimeNs,
+            endTimeUnixNano: endTimeNs,
+            attributes: Object.keys(attrs).length > 0 ? attrs : null,
+            events: events.length > 0 ? events : null,
+            links: links.length > 0 ? links : null,
+            status,
+        };
+    }
+    async shutdown() {
+        this.closed = true;
+    }
+    async forceFlush() {
+        // No-op — spans are exported immediately on export() call
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=Agent365Exporter.js.map

package/dist/esm/a365/exporter/Agent365Exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent365Exporter.js","sourceRoot":"","sources":["../../../../src/a365/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,uBAAuB,EACvB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAiD9B;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,GAAG,KAAK,CAAC;IACN,OAAO,CAA0B;IACjC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE/C,YAAY,OAAiC;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAqB,EACrB,cAA8C;QAE9C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAE1C,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,MAAM,QAAQ,GAAoB,EAAE,CAAC;YAErC,KAAK,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACtE,UAAU,GAAG,IAAI,CAAC;oBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC;gBACrF,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5B,cAAc,CAAC;gBACb,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO;aACtE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;YAC5D,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,WAAmB,EAAE,KAAqB;QAClE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc;YAC9C,CAAC,CAAC,iCAAiC,kBAAkB,CAAC,QAAQ,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,SAAS;YAC9G,CAAC,CAAC,0BAA0B,kBAAkB,CAAC,QAAQ,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC;QAE1G,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACvF,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,YAAY,gBAAgB,CAAC;QAEtD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,gBAAgB,EAAE,QAAQ;SAC3B,CAAC;QAEF,gBAAgB;QAChB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,0CAA0C,QAAQ,IAAI,OAAO,sBAAsB,CACpF,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;QAE7C,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,QAAgB;QAC1D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7D,OAAO,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,GAAW,EACX,IAAY,EACZ,OAA+B;QAE/B,IAAI,iBAAiB,GAAG,SAAS,CAAC;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,mBAAmB,EAAE,OAAO,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAChC,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI;oBACJ,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC;iBACzE,CAAC,CAAC;gBAEH,MAAM,aAAa,GACjB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;oBAC3C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;oBACxC,SAAS,CAAC;gBACZ,iBAAiB,GAAG,aAAa,CAAC;gBAElC,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;gBACrC,CAAC;gBAED,4BAA4B;gBAC5B,IACE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACpC,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,EACjD,CAAC;oBACD,IAAI,OAAO,GAAG,mBAAmB,EAAE,CAAC;wBAClC,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;wBACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,sCAAsC,QAAQ,CAAC,MAAM,oBAAoB,OAAO,IAAI,CACrF,CAAC;wBACF,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;wBACrB,SAAS;oBACX,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,yCAAyC,QAAQ,CAAC,MAAM,kBAAkB,aAAa,EAAE,CAC1F,CAAC;gBACF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;gBAC9D,IAAI,OAAO,GAAG,mBAAmB,EAAE,CAAC;oBAClC,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;oBACjC,SAAS;gBACX,CAAC;gBACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;YACzD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACzD,CAAC;IAEO,kBAAkB,CAAC,KAAqB;QAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;QAE/C,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,EAAE,CAAC,oBAAoB,CAAC;YACtC,MAAM,QAAQ,GAAG,GAAG,KAAK,EAAE,IAAI,IAAI,SAAS,IAAI,KAAK,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;YACvE,IAAI,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,EAAE,CAAC;gBACd,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE;gBAC9C,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,aAAa,GAA4B,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;YACtD,aAAa,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtD,CAAC;QAED,OAAO;YACL,aAAa,EAAE;gBACb;oBACE,QAAQ,EAAE;wBACR,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;qBACzE;oBACD,UAAU;iBACX;aACF;SACF,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,EAAgB;QAC9B,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAE7B,IAAI,YAAgC,CAAC;QACrC,IAAI,EAAE,CAAC,iBAAiB,EAAE,MAAM,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YACvF,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAExD,MAAM,MAAM,GAAgB,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACvD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC;gBACnC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzC,CAAC,CAAE,EAAE,CAAC,IAAe,CAAC;YACxB,MAAM,OAAO,GACX,EAAE,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAe,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACpD,MAAM,OAAO,GACX,EAAE,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvF,OAAO;gBACL,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;gBACvC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBACpC,UAAU,EAAE,OAAO;aACpB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAe;YACzB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC;YACtC,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE;SAClC,CAAC;QAEF,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC;YAC7C,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;YACnD,CAAC,CAAE,EAAE,CAAC,SAAoB,CAAC;QAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACzC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAE,EAAE,CAAC,OAAkB,CAAC;QAE3B,OAAO;YACL,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAC7B,YAAY;YACZ,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC;YACvB,iBAAiB,EAAE,WAAW;YAC9B,eAAe,EAAE,SAAS;YAC1B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACxD,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YACzC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACtC,MAAM;SACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,0DAA0D;IAC5D,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/esm/a365/exporter/Agent365ExporterOptions.d.ts

@@ -0,0 +1,43 @@
+import type { ClusterCategory } from "../configuration/A365ConfigurationOptions.js";
+/**
+ * A function that resolves an authentication token for the given agent and tenant.
+ * Return null if a token cannot be provided.
+ */
+export type TokenResolver = (agentId: string, tenantId: string) => string | null | Promise<string | null>;
+/**
+ * Options controlling the behavior of the Agent365 span exporter.
+ */
+export interface Agent365ExporterOptions {
+    /** Cluster category for endpoint resolution. @default "prod" */
+    clusterCategory?: ClusterCategory;
+    /** Token resolver for authentication. Required for batch export. */
+    tokenResolver?: TokenResolver;
+    /** When true, use the S2S endpoint path (/observabilityService/...). @default false */
+    useS2SEndpoint?: boolean;
+    /** Override the A365 observability service domain. */
+    domainOverride?: string;
+    /** Maximum span queue size before drops occur. @default 2048 */
+    maxQueueSize?: number;
+    /** Delay (ms) between automatic batch flush attempts. @default 5000 */
+    scheduledDelayMilliseconds?: number;
+    /** Maximum time (ms) for the entire export() call. @default 90000 */
+    exporterTimeoutMilliseconds?: number;
+    /** Timeout (ms) per individual HTTP request. Each retry gets a fresh timeout. @default 30000 */
+    httpRequestTimeoutMilliseconds?: number;
+    /** Maximum number of spans per export batch. @default 512 */
+    maxExportBatchSize?: number;
+}
+/** Resolved options with defaults applied. */
+export declare class ResolvedExporterOptions {
+    readonly clusterCategory: ClusterCategory;
+    readonly tokenResolver?: TokenResolver;
+    readonly useS2SEndpoint: boolean;
+    readonly domainOverride?: string;
+    readonly maxQueueSize: number;
+    readonly scheduledDelayMilliseconds: number;
+    readonly exporterTimeoutMilliseconds: number;
+    readonly httpRequestTimeoutMilliseconds: number;
+    readonly maxExportBatchSize: number;
+    constructor(options?: Agent365ExporterOptions);
+}
+//# sourceMappingURL=Agent365ExporterOptions.d.ts.map

package/dist/esm/a365/exporter/Agent365ExporterOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent365ExporterOptions.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/Agent365ExporterOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,KACb,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,oEAAoE;IACpE,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,uEAAuE;IACvE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,qEAAqE;IACrE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC,gGAAgG;IAChG,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExC,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,8CAA8C;AAC9C,qBAAa,uBAAuB;IAClC,SAAgB,eAAe,EAAE,eAAe,CAAC;IACjD,SAAgB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9C,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,0BAA0B,EAAE,MAAM,CAAC;IACnD,SAAgB,2BAA2B,EAAE,MAAM,CAAC;IACpD,SAAgB,8BAA8B,EAAE,MAAM,CAAC;IACvD,SAAgB,kBAAkB,EAAE,MAAM,CAAC;gBAE/B,OAAO,CAAC,EAAE,uBAAuB;CAW9C"}

package/dist/esm/a365/exporter/Agent365ExporterOptions.js

@@ -0,0 +1,26 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/** Resolved options with defaults applied. */
+export class ResolvedExporterOptions {
+    clusterCategory;
+    tokenResolver;
+    useS2SEndpoint;
+    domainOverride;
+    maxQueueSize;
+    scheduledDelayMilliseconds;
+    exporterTimeoutMilliseconds;
+    httpRequestTimeoutMilliseconds;
+    maxExportBatchSize;
+    constructor(options) {
+        this.clusterCategory = options?.clusterCategory ?? "prod";
+        this.tokenResolver = options?.tokenResolver;
+        this.useS2SEndpoint = options?.useS2SEndpoint ?? false;
+        this.domainOverride = options?.domainOverride;
+        this.maxQueueSize = options?.maxQueueSize ?? 2048;
+        this.scheduledDelayMilliseconds = options?.scheduledDelayMilliseconds ?? 5000;
+        this.exporterTimeoutMilliseconds = options?.exporterTimeoutMilliseconds ?? 90000;
+        this.httpRequestTimeoutMilliseconds = options?.httpRequestTimeoutMilliseconds ?? 30000;
+        this.maxExportBatchSize = options?.maxExportBatchSize ?? 512;
+    }
+}
+//# sourceMappingURL=Agent365ExporterOptions.js.map

package/dist/esm/a365/exporter/Agent365ExporterOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent365ExporterOptions.js","sourceRoot":"","sources":["../../../../src/a365/exporter/Agent365ExporterOptions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AA6ClC,8CAA8C;AAC9C,MAAM,OAAO,uBAAuB;IAClB,eAAe,CAAkB;IACjC,aAAa,CAAiB;IAC9B,cAAc,CAAU;IACxB,cAAc,CAAU;IACxB,YAAY,CAAS;IACrB,0BAA0B,CAAS;IACnC,2BAA2B,CAAS;IACpC,8BAA8B,CAAS;IACvC,kBAAkB,CAAS;IAE3C,YAAY,OAAiC;QAC3C,IAAI,CAAC,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,MAAM,CAAC;QAC1D,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;QAC5C,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;QACvD,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,0BAA0B,GAAG,OAAO,EAAE,0BAA0B,IAAI,IAAI,CAAC;QAC9E,IAAI,CAAC,2BAA2B,GAAG,OAAO,EAAE,2BAA2B,IAAI,KAAK,CAAC;QACjF,IAAI,CAAC,8BAA8B,GAAG,OAAO,EAAE,8BAA8B,IAAI,KAAK,CAAC;QACvF,IAAI,CAAC,kBAAkB,GAAG,OAAO,EAAE,kBAAkB,IAAI,GAAG,CAAC;IAC/D,CAAC;CACF"}

package/dist/esm/a365/exporter/ExporterEventNames.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Event names used by Agent365Exporter for logging and monitoring.
+ */
+export declare enum ExporterEventNames {
+    EXPORT = "agent365-export",
+    EXPORT_GROUP = "export-group",
+    EXPORT_PARTITION_SPAN_MISSING_IDENTITY = "export-partition-span-missing-identity"
+}
+//# sourceMappingURL=ExporterEventNames.d.ts.map

package/dist/esm/a365/exporter/ExporterEventNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExporterEventNames.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/ExporterEventNames.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,oBAAoB;IAC1B,YAAY,iBAAiB;IAC7B,sCAAsC,2CAA2C;CAClF"}

package/dist/esm/a365/exporter/ExporterEventNames.js

@@ -0,0 +1,12 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Event names used by Agent365Exporter for logging and monitoring.
+ */
+export var ExporterEventNames;
+(function (ExporterEventNames) {
+    ExporterEventNames["EXPORT"] = "agent365-export";
+    ExporterEventNames["EXPORT_GROUP"] = "export-group";
+    ExporterEventNames["EXPORT_PARTITION_SPAN_MISSING_IDENTITY"] = "export-partition-span-missing-identity";
+})(ExporterEventNames || (ExporterEventNames = {}));
+//# sourceMappingURL=ExporterEventNames.js.map

package/dist/esm/a365/exporter/ExporterEventNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExporterEventNames.js","sourceRoot":"","sources":["../../../../src/a365/exporter/ExporterEventNames.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;GAEG;AACH,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,gDAA0B,CAAA;IAC1B,mDAA6B,CAAA;IAC7B,uGAAiF,CAAA;AACnF,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}

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

@@ -0,0 +1,6 @@
+export { Agent365Exporter } from "./Agent365Exporter.js";
+export type { Agent365ExporterOptions, TokenResolver } from "./Agent365ExporterOptions.js";
+export { ResolvedExporterOptions } from "./Agent365ExporterOptions.js";
+export { ExporterEventNames } from "./ExporterEventNames.js";
+export { truncateSpan, MAX_SPAN_SIZE_BYTES } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,7 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { Agent365Exporter } from "./Agent365Exporter.js";
+export { ResolvedExporterOptions } from "./Agent365ExporterOptions.js";
+export { ExporterEventNames } from "./ExporterEventNames.js";
+export { truncateSpan, MAX_SPAN_SIZE_BYTES } from "./utils.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/a365/exporter/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import type { ClusterCategory } from "../configuration/A365ConfigurationOptions.js";
+/**
+ * Partition spans by (tenantId, agentId) identity pairs.
+ * Spans missing either attribute are skipped.
+ */
+export declare function partitionByIdentity(spans: ReadableSpan[]): Map<string, ReadableSpan[]>;
+/** Parse identity key back to tenant and agent IDs. */
+export declare function parseIdentityKey(key: string): {
+    tenantId: string;
+    agentId: string;
+};
+/** Convert trace ID to hex string (32 hex chars). */
+export declare function hexTraceId(value: string | number): string;
+/** Convert span ID to hex string (16 hex chars). */
+export declare function hexSpanId(value: string | number): string;
+/** Convert any value to a trimmed string, or undefined if empty/null. */
+export declare function asStr(v: unknown): string | undefined;
+/** Get span kind name. */
+export declare function kindName(kind: SpanKind): string;
+/** Get status name. */
+export declare function statusName(code: SpanStatusCode): string;
+/**
+ * Resolve the Agent365 service endpoint base URI for a given cluster category.
+ */
+export declare function resolveAgent365Endpoint(clusterCategory: ClusterCategory): string;
+/** Maximum allowed span size in bytes (250KB). */
+export declare const MAX_SPAN_SIZE_BYTES: number;
+interface OTLPSpanLike {
+    attributes: Record<string, unknown> | null;
+}
+/**
+ * Truncate span attributes if the serialized span exceeds MAX_SPAN_SIZE_BYTES.
+ *
+ * Phase 1: iteratively shrink fields (blobs, text, json, strings) by size priority.
+ * Phase 2 (fallback): replace remaining string attributes with overlimit sentinel.
+ */
+export declare function truncateSpan<T extends OTLPSpanLike>(spanDict: T): T;
+export {};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAmBpF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CA8BtF;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAGnF;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKzD;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKxD;AAED,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIpD;AAED,0BAA0B;AAC1B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAe/C;AAED,uBAAuB;AACvB,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAWvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAUhF;AAID,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAS9C,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C;AA+QD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAqEnE"}