@microsoft/agents-a365-observability 0.1.0-preview.30

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

@@ -0,0 +1,281 @@
+import { ExportResultCode } from '@opentelemetry/core';
+import { PowerPlatformApiDiscovery } from '@microsoft/agents-a365-runtime';
+import { partitionByIdentity, parseIdentityKey, hexTraceId, hexSpanId, kindName, statusName } from './utils';
+import logger, { formatError } from '../../utils/logging';
+const DEFAULT_HTTP_TIMEOUT_SECONDS = 30000; // 30 seconds in ms
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Observability span exporter for Agent365:
+ * - Partitions spans by (tenantId, agentId)
+ * - Builds OTLP-like JSON: resourceSpans -> scopeSpans -> spans
+ * - POSTs per group to https://{endpoint}/maven/agent365/agents/{agentId}/traces?api-version=1
+ * - Adds Bearer token via token_resolver(agentId, tenantId)
+ */
+export class Agent365Exporter {
+    constructor(tokenResolver, clusterCategory = 'prod') {
+        this.closed = false;
+        if (!tokenResolver) {
+            logger.error('[Agent365Exporter] token_resolver is not provided');
+            throw new Error('token_resolver must be provided.');
+        }
+        this.tokenResolver = tokenResolver;
+        this.clusterCategory = clusterCategory;
+    }
+    /**
+     * Export spans to Agent365 service
+     */
+    async export(spans, resultCallback) {
+        if (this.closed) {
+            resultCallback({ code: ExportResultCode.FAILED });
+            return;
+        }
+        try {
+            logger.info(`[Agent365Exporter] Exporting ${spans.length} spans`);
+            const groups = partitionByIdentity(spans);
+            if (groups.size === 0) {
+                logger.info('[Agent365Exporter] No groups to export');
+                resultCallback({ code: ExportResultCode.SUCCESS });
+                return;
+            }
+            logger.info(`[Agent365Exporter] Exporting ${groups.size} identity groups`);
+            let anyFailure = false;
+            const promises = [];
+            for (const [identityKey, activities] of groups) {
+                const promise = this.exportGroup(identityKey, activities).catch(() => {
+                    anyFailure = true;
+                });
+                promises.push(promise);
+            }
+            await Promise.all(promises);
+            logger.info(`[Agent365Exporter] Export completed. Success: ${!anyFailure}`);
+            resultCallback({
+                code: anyFailure ? ExportResultCode.FAILED : ExportResultCode.SUCCESS
+            });
+        }
+        catch (error) {
+            // Exporters should not raise; signal failure
+            resultCallback({ code: ExportResultCode.FAILED });
+        }
+    }
+    /**
+     * Export a group of spans for a specific identity
+     */
+    async exportGroup(identityKey, spans) {
+        const { tenantId, agentId } = parseIdentityKey(identityKey);
+        logger.info(`[Agent365Exporter] Exporting ${spans.length} spans for tenantId: ${tenantId}, agentId: ${agentId}`);
+        const payload = this.buildExportRequest(spans);
+        const body = JSON.stringify(payload);
+        // Resolve endpoint + token based on cluster category (defaults to 'prod')
+        const discovery = new PowerPlatformApiDiscovery(this.clusterCategory);
+        const endpoint = discovery.getTenantIslandClusterEndpoint(tenantId);
+        const url = `https://${endpoint}/maven/agent365/agents/${agentId}/traces?api-version=1`;
+        logger.info(`[Agent365Exporter] Resolved endpoint: ${endpoint}`);
+        const headers = {
+            'content-type': 'application/json'
+        };
+        const tokenResult = this.tokenResolver(agentId, tenantId);
+        const token = tokenResult instanceof Promise ? await tokenResult : tokenResult;
+        if (token) {
+            headers['authorization'] = `Bearer ${token}`;
+            logger.info('[Agent365Exporter] Token resolved successfully');
+        }
+        else {
+            logger.error('[Agent365Exporter] No token resolved');
+        }
+        // Basic retry loop
+        const ok = await this.postWithRetries(url, body, headers);
+        if (!ok) {
+            logger.error('[Agent365Exporter] Failed to export spans');
+            throw new Error('Failed to export spans');
+        }
+        logger.info('[Agent365Exporter] Successfully exported spans');
+    }
+    /**
+     * HTTP POST with retry logic
+     */
+    async postWithRetries(url, body, headers) {
+        for (let attempt = 0; attempt <= DEFAULT_MAX_RETRIES; attempt++) {
+            let correlationId;
+            try {
+                logger.info(`[Agent365Exporter] Posting OTLP export request - Attempt ${attempt + 1}`);
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body,
+                    signal: AbortSignal.timeout(DEFAULT_HTTP_TIMEOUT_SECONDS)
+                });
+                correlationId = response?.headers?.get('x-ms-correlation-id') || response?.headers?.get('x-correlation-id') || 'unknown';
+                // 2xx => success
+                if (response.status >= 200 && response.status < 300) {
+                    logger.info(`[Agent365Exporter] Success with status ${response.status}, correlation ID: ${correlationId}`);
+                    return true;
+                }
+                // Retry transient errors
+                if ([408, 429].includes(response.status) || (response.status >= 500 && response.status < 600)) {
+                    if (attempt < DEFAULT_MAX_RETRIES) {
+                        const sleepMs = 200 * (attempt + 1);
+                        logger.warn(`[Agent365Exporter] Transient error ${response.status}, correlation ID: ${correlationId}, retrying after ${sleepMs}ms`);
+                        await this.sleep(sleepMs);
+                        continue;
+                    }
+                }
+                logger.error(`[Agent365Exporter] Failed with status ${response.status}, correlation ID: ${correlationId}`);
+                return false;
+            }
+            catch (error) {
+                logger.error('[Agent365Exporter] Request error:', formatError(error));
+                if (attempt < DEFAULT_MAX_RETRIES) {
+                    const sleepMs = 200 * (attempt + 1);
+                    logger.info(`[Agent365Exporter] Retrying after ${sleepMs}ms`);
+                    await this.sleep(sleepMs);
+                    continue;
+                }
+                return false;
+            }
+        }
+        return false;
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Build OTLP export request payload
+     */
+    buildExportRequest(spans) {
+        // Group by instrumentation scope (name, version)
+        const scopeMap = new Map();
+        logger.info('[Agent365Exporter] Building OTLP export request payload');
+        for (const sp of spans) {
+            const scope = sp.instrumentationScope || sp.instrumentationLibrary;
+            const scopeKey = `${scope?.name || 'unknown'}:${scope?.version || ''}`;
+            const existing = scopeMap.get(scopeKey) || [];
+            existing.push(this.mapSpan(sp));
+            scopeMap.set(scopeKey, existing);
+        }
+        const scopeSpans = [];
+        for (const [scopeKey, mappedSpans] of scopeMap) {
+            const [name, version] = scopeKey.split(':');
+            scopeSpans.push({
+                scope: {
+                    name,
+                    version: version || undefined,
+                },
+                spans: mappedSpans,
+            });
+        }
+        // Resource attributes (from the first span - all spans in a batch usually share resource)
+        let resourceAttrs = {};
+        if (spans.length > 0) {
+            const firstSpanResource = spans[0].resource?.attributes;
+            if (firstSpanResource) {
+                resourceAttrs = { ...firstSpanResource };
+            }
+        }
+        return {
+            resourceSpans: [
+                {
+                    resource: { attributes: Object.keys(resourceAttrs).length > 0 ? resourceAttrs : null },
+                    scopeSpans,
+                }
+            ]
+        };
+    }
+    /**
+     * Map a ReadableSpan to OTLP span format
+     */
+    mapSpan(sp) {
+        const spanContext = sp.spanContext();
+        // Extract parent span ID - check multiple possible sources
+        let parentSpanIdHex = undefined;
+        const parentContext = sp.parentSpanContext;
+        if (parentContext?.spanId && parentContext.spanId !== '0000000000000000') {
+            parentSpanIdHex = hexSpanId(parentContext.spanId);
+        }
+        // attributes
+        const attrs = sp.attributes ? { ...sp.attributes } : {};
+        // events
+        const events = [];
+        for (const ev of sp.events || []) {
+            // Handle both hrtime arrays and direct nanosecond timestamps
+            let timeNs;
+            if (Array.isArray(ev.time)) {
+                timeNs = ev.time[0] * 1000000000 + ev.time[1];
+            }
+            else {
+                timeNs = ev.time;
+            }
+            const evAttrs = ev.attributes && Object.keys(ev.attributes).length > 0 ? { ...ev.attributes } : null;
+            events.push({
+                timeUnixNano: timeNs,
+                name: ev.name,
+                attributes: evAttrs,
+            });
+        }
+        // links
+        const links = [];
+        for (const ln of sp.links || []) {
+            const lnAttrs = ln.attributes && Object.keys(ln.attributes).length > 0 ? { ...ln.attributes } : null;
+            links.push({
+                traceId: hexTraceId(ln.context.traceId),
+                spanId: hexSpanId(ln.context.spanId),
+                attributes: lnAttrs,
+            });
+        }
+        // status
+        const statusCode = sp.status?.code ?? 0; // Default to UNSET (0) if no status
+        const status = {
+            code: statusName(statusCode),
+            message: sp.status?.message || '',
+        };
+        // Convert hrtime to nanoseconds - handle both hrtime arrays and direct nanosecond values
+        let startTimeNs;
+        let endTimeNs;
+        if (Array.isArray(sp.startTime)) {
+            // hrtime format [seconds, nanoseconds]
+            startTimeNs = sp.startTime[0] * 1000000000 + sp.startTime[1];
+        }
+        else {
+            // Direct nanosecond value
+            startTimeNs = sp.startTime;
+        }
+        if (Array.isArray(sp.endTime)) {
+            // hrtime format [seconds, nanoseconds]
+            endTimeNs = sp.endTime[0] * 1000000000 + sp.endTime[1];
+        }
+        else {
+            // Direct nanosecond value
+            endTimeNs = sp.endTime;
+        }
+        return {
+            traceId: hexTraceId(spanContext.traceId),
+            spanId: hexSpanId(spanContext.spanId),
+            parentSpanId: parentSpanIdHex,
+            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,
+        };
+    }
+    /**
+     * Shutdown the exporter
+     */
+    async shutdown() {
+        logger.info('[Agent365Exporter] Shutting down exporter');
+        this.closed = true;
+    }
+    /**
+     * Force flush any pending spans
+     */
+    async forceFlush() {
+        // No-op for this implementation
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=Agent365Exporter.js.map

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

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

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

@@ -0,0 +1,38 @@
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { SpanKind, SpanStatusCode } from '@opentelemetry/api';
+/**
+ * Convert trace ID to hex string format
+ */
+export declare function hexTraceId(value: string | number): string;
+/**
+ * Convert span ID to hex string format
+ */
+export declare function hexSpanId(value: string | number): string;
+/**
+ * Convert any value to string, handling null/undefined
+ */
+export declare function asStr(v: unknown): string | undefined;
+/**
+ * Get span kind name from SpanKind enum
+ */
+export declare function kindName(kind: SpanKind): string;
+/**
+ * Get status name from SpanStatusCode enum
+ */
+export declare function statusName(code: SpanStatusCode): string;
+/**
+ * Partition spans by (tenantId, agentId) identity pairs
+ */
+export declare function partitionByIdentity(spans: ReadableSpan[]): Map<string, ReadableSpan[]>;
+/**
+ * Check if Agent 365 exporter is enabled via environment variable
+ */
+export declare function isAgent365ExporterEnabled(): boolean;
+/**
+ * Parse identity key back to tenant and agent IDs
+ */
+export declare function parseIdentityKey(key: string): {
+    tenantId: string;
+    agentId: string;
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/tracing/exporter/utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAI9D;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAOzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAOxD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAe/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAWvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAuB7B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAMnD;AAGD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAGnF"}

package/dist/esm/tracing/exporter/utils.js

@@ -0,0 +1,113 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { SpanKind, SpanStatusCode } from '@opentelemetry/api';
+import { OpenTelemetryConstants } from '../constants';
+import logger from '../../utils/logging';
+/**
+ * Convert trace ID to hex string format
+ */
+export function hexTraceId(value) {
+    if (typeof value === 'number') {
+        // Convert integer to 32 hex chars (128-bit)
+        return value.toString(16).padStart(32, '0');
+    }
+    // Handle hex string input - ensure it's 32 hex characters
+    return value.replace(/^0x/, '').padStart(32, '0');
+}
+/**
+ * Convert span ID to hex string format
+ */
+export function hexSpanId(value) {
+    if (typeof value === 'number') {
+        // Convert integer to 16 hex chars (64-bit)
+        return value.toString(16).padStart(16, '0');
+    }
+    // Handle hex string input - ensure it's 16 hex characters
+    return value.replace(/^0x/, '').padStart(16, '0');
+}
+/**
+ * Convert any value to string, handling null/undefined
+ */
+export function asStr(v) {
+    if (v === null || v === undefined) {
+        return undefined;
+    }
+    const s = String(v);
+    return s.trim() ? s : undefined;
+}
+/**
+ * Get span kind name from SpanKind enum
+ */
+export function kindName(kind) {
+    switch (kind) {
+        case SpanKind.INTERNAL:
+            return 'INTERNAL';
+        case SpanKind.SERVER:
+            return 'SERVER';
+        case SpanKind.CLIENT:
+            return 'CLIENT';
+        case SpanKind.PRODUCER:
+            return 'PRODUCER';
+        case SpanKind.CONSUMER:
+            return 'CONSUMER';
+        default:
+            return 'UNSPECIFIED';
+    }
+}
+/**
+ * Get status name from SpanStatusCode enum
+ */
+export function statusName(code) {
+    switch (code) {
+        case SpanStatusCode.UNSET:
+            return 'UNSET';
+        case SpanStatusCode.OK:
+            return 'OK';
+        case SpanStatusCode.ERROR:
+            return 'ERROR';
+        default:
+            return 'UNSET';
+    }
+}
+/**
+ * Partition spans by (tenantId, agentId) identity pairs
+ */
+export function partitionByIdentity(spans) {
+    const groups = new Map();
+    let skippedCount = 0;
+    for (const span of spans) {
+        const attrs = span.attributes || {};
+        const tenant = asStr(attrs[OpenTelemetryConstants.TENANT_ID_KEY]);
+        const agent = asStr(attrs[OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY]);
+        if (!tenant || !agent) {
+            skippedCount++;
+            logger.warn(`[Agent365Exporter] Skipping span without tenant or agent ID. Span name: ${span.name}`);
+            continue;
+        }
+        const key = `${tenant}:${agent}`;
+        const existing = groups.get(key) || [];
+        existing.push(span);
+        groups.set(key, existing);
+    }
+    logger.info(`[Agent365Exporter] Partitioned into ${groups.size} identity groups (${skippedCount} spans skipped)`);
+    return groups;
+}
+/**
+ * Check if Agent 365 exporter is enabled via environment variable
+ */
+export function isAgent365ExporterEnabled() {
+    const a365Env = process.env[OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY_EXPORTER]?.toLowerCase() || '';
+    const validValues = ['true', '1', 'yes', 'on'];
+    const enabled = validValues.includes(a365Env);
+    logger.info(`[Agent365Exporter] Agent 365 exporter enabled: ${enabled}`);
+    return enabled;
+}
+/**
+ * Parse identity key back to tenant and agent IDs
+ */
+export function parseIdentityKey(key) {
+    const [tenantId, agentId] = key.split(':');
+    return { tenantId, agentId };
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/tracing/exporter/utils.js.map

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

package/dist/esm/tracing/middleware/BaggageBuilder.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Per request baggage builder for OpenTelemetry context propagation.
+ *
+ * This class provides a fluent API for setting baggage values that will be
+ * propagated in the OpenTelemetry context.
+ *
+ * @example
+ * ```typescript
+ * const scope = new BaggageBuilder()
+ *   .tenantId("tenant-123")
+ *   .agentId("agent-456")
+ *   .correlationId("corr-789")
+ *   .build();
+ *
+ * scope.enter();
+ * // Baggage is set in this context
+ * // ... do work ...
+ * scope.exit();
+ * // Baggage is restored after exiting the context
+ * ```
+ */
+export declare class BaggageBuilder {
+    private pairs;
+    /**
+     * Set the operation source baggage value.
+     * @param value The operation source value
+     * @returns Self for method chaining
+     */
+    operationSource(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the tenant ID baggage value.
+     * @param value The tenant ID
+     * @returns Self for method chaining
+     */
+    tenantId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the agent ID baggage value.
+     * @param value The agent ID
+     * @returns Self for method chaining
+     */
+    agentId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the agent AUID baggage value.
+     * @param value The agent AUID
+     * @returns Self for method chaining
+     */
+    agentAuid(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the agent UPN baggage value.
+     * @param value The agent UPN
+     * @returns Self for method chaining
+     */
+    agentUpn(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the agent blueprint ID baggage value.
+     * @param value The agent blueprint ID
+     * @returns Self for method chaining
+     */
+    agentBlueprintId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the correlation ID baggage value.
+     * @param value The correlation ID
+     * @returns Self for method chaining
+     */
+    correlationId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the caller ID baggage value.
+     * @param value The caller ID
+     * @returns Self for method chaining
+     */
+    callerId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the hiring manager ID baggage value.
+     * @param value The hiring manager ID
+     * @returns Self for method chaining
+     */
+    hiringManagerId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the agent name baggage value.
+     * @param value The agent name
+     * @returns Self for method chaining
+     */
+    agentName(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the agent description baggage value.
+     * @param value The agent description
+     * @returns Self for method chaining
+     */
+    agentDescription(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the caller name baggage value.
+     * @param value The caller name
+     * @returns Self for method chaining
+     */
+    callerName(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the caller UPN baggage value.
+     * @param value The caller UPN
+     * @returns Self for method chaining
+     */
+    callerUpn(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the conversation ID baggage value.
+     * @param value The conversation ID
+     * @returns Self for method chaining
+     */
+    conversationId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the conversation item link baggage value.
+     * @param value The conversation item link
+     * @returns Self for method chaining
+     */
+    conversationItemLink(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the execution source metadata ID (e.g., channel ID).
+     * @param value The source metadata ID
+     * @returns Self for method chaining
+     */
+    sourceMetadataId(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the execution source metadata name (e.g., channel name).
+     * @param value The source metadata name
+     * @returns Self for method chaining
+     */
+    sourceMetadataName(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set the execution source metadata description (e.g., channel description).
+     * @param value The source metadata description
+     * @returns Self for method chaining
+     */
+    sourceMetadataDescription(value: string | null | undefined): BaggageBuilder;
+    /**
+     * Set multiple baggage pairs from a dictionary or iterable.
+     * @param pairs Dictionary or iterable of key-value pairs
+     * @returns Self for method chaining
+     */
+    setPairs(pairs: Record<string, any> | Iterable<[string, any]> | null | undefined): BaggageBuilder;
+    /**
+     * Apply the collected baggage to the current context.
+     * @returns A context manager that restores the previous baggage on exit
+     */
+    build(): BaggageScope;
+    /**
+     * Add a baggage key/value if the value is not null or whitespace.
+     * @param key The baggage key
+     * @param value The baggage value
+     */
+    private set;
+    /**
+     * Convenience method to begin a request baggage scope with common fields.
+     * @param tenantId The tenant ID
+     * @param agentId The agent ID
+     * @param correlationId The correlation ID
+     * @returns A context manager that restores the previous baggage on exit
+     */
+    static setRequestContext(tenantId?: string | null, agentId?: string | null, correlationId?: string | null): BaggageScope;
+}
+/**
+ * Context manager for baggage scope.
+ *
+ * This class manages the lifecycle of baggage values, setting them on enter
+ * and restoring the previous context on exit.
+ */
+export declare class BaggageScope implements Disposable {
+    private readonly contextWithBaggage;
+    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/tracing/middleware/BaggageBuilder.d.ts.map

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