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

package/dist/cjs/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/cjs/tracing/exporter/utils.js

@@ -0,0 +1,126 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexTraceId = hexTraceId;
+exports.hexSpanId = hexSpanId;
+exports.asStr = asStr;
+exports.kindName = kindName;
+exports.statusName = statusName;
+exports.partitionByIdentity = partitionByIdentity;
+exports.isAgent365ExporterEnabled = isAgent365ExporterEnabled;
+exports.parseIdentityKey = parseIdentityKey;
+const api_1 = require("@opentelemetry/api");
+const constants_1 = require("../constants");
+const logging_1 = __importDefault(require("../../utils/logging"));
+/**
+ * Convert trace ID to hex string format
+ */
+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
+ */
+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
+ */
+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
+ */
+function kindName(kind) {
+    switch (kind) {
+        case api_1.SpanKind.INTERNAL:
+            return 'INTERNAL';
+        case api_1.SpanKind.SERVER:
+            return 'SERVER';
+        case api_1.SpanKind.CLIENT:
+            return 'CLIENT';
+        case api_1.SpanKind.PRODUCER:
+            return 'PRODUCER';
+        case api_1.SpanKind.CONSUMER:
+            return 'CONSUMER';
+        default:
+            return 'UNSPECIFIED';
+    }
+}
+/**
+ * Get status name from SpanStatusCode enum
+ */
+function statusName(code) {
+    switch (code) {
+        case api_1.SpanStatusCode.UNSET:
+            return 'UNSET';
+        case api_1.SpanStatusCode.OK:
+            return 'OK';
+        case api_1.SpanStatusCode.ERROR:
+            return 'ERROR';
+        default:
+            return 'UNSET';
+    }
+}
+/**
+ * Partition spans by (tenantId, agentId) identity pairs
+ */
+function partitionByIdentity(spans) {
+    const groups = new Map();
+    let skippedCount = 0;
+    for (const span of spans) {
+        const attrs = span.attributes || {};
+        const tenant = asStr(attrs[constants_1.OpenTelemetryConstants.TENANT_ID_KEY]);
+        const agent = asStr(attrs[constants_1.OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY]);
+        if (!tenant || !agent) {
+            skippedCount++;
+            logging_1.default.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);
+    }
+    logging_1.default.info(`[Agent365Exporter] Partitioned into ${groups.size} identity groups (${skippedCount} spans skipped)`);
+    return groups;
+}
+/**
+ * Check if Agent 365 exporter is enabled via environment variable
+ */
+function isAgent365ExporterEnabled() {
+    const a365Env = process.env[constants_1.OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY_EXPORTER]?.toLowerCase() || '';
+    const validValues = ['true', '1', 'yes', 'on'];
+    const enabled = validValues.includes(a365Env);
+    logging_1.default.info(`[Agent365Exporter] Agent 365 exporter enabled: ${enabled}`);
+    return enabled;
+}
+/**
+ * Parse identity key back to tenant and agent IDs
+ */
+function parseIdentityKey(key) {
+    const [tenantId, agentId] = key.split(':');
+    return { tenantId, agentId };
+}
+//# sourceMappingURL=utils.js.map

package/dist/cjs/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/cjs/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/cjs/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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"}

package/dist/cjs/tracing/middleware/BaggageBuilder.js

@@ -0,0 +1,297 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaggageScope = exports.BaggageBuilder = void 0;
+const api_1 = require("@opentelemetry/api");
+const constants_1 = require("../constants");
+/**
+ * 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
+ * ```
+ */
+class BaggageBuilder {
+    constructor() {
+        this.pairs = new Map();
+    }
+    /**
+     * Set the operation source baggage value.
+     * @param value The operation source value
+     * @returns Self for method chaining
+     */
+    operationSource(value) {
+        this.set(constants_1.OpenTelemetryConstants.OPERATION_SOURCE_KEY, value);
+        return this;
+    }
+    /**
+     * Set the tenant ID baggage value.
+     * @param value The tenant ID
+     * @returns Self for method chaining
+     */
+    tenantId(value) {
+        this.set(constants_1.OpenTelemetryConstants.TENANT_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent ID baggage value.
+     * @param value The agent ID
+     * @returns Self for method chaining
+     */
+    agentId(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent AUID baggage value.
+     * @param value The agent AUID
+     * @returns Self for method chaining
+     */
+    agentAuid(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent UPN baggage value.
+     * @param value The agent UPN
+     * @returns Self for method chaining
+     */
+    agentUpn(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_UPN_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent blueprint ID baggage value.
+     * @param value The agent blueprint ID
+     * @returns Self for method chaining
+     */
+    agentBlueprintId(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the correlation ID baggage value.
+     * @param value The correlation ID
+     * @returns Self for method chaining
+     */
+    correlationId(value) {
+        this.set(constants_1.OpenTelemetryConstants.CORRELATION_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the caller ID baggage value.
+     * @param value The caller ID
+     * @returns Self for method chaining
+     */
+    callerId(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the hiring manager ID baggage value.
+     * @param value The hiring manager ID
+     * @returns Self for method chaining
+     */
+    hiringManagerId(value) {
+        this.set(constants_1.OpenTelemetryConstants.HIRING_MANAGER_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent name baggage value.
+     * @param value The agent name
+     * @returns Self for method chaining
+     */
+    agentName(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent description baggage value.
+     * @param value The agent description
+     * @returns Self for method chaining
+     */
+    agentDescription(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /**
+     * Set the caller name baggage value.
+     * @param value The caller name
+     * @returns Self for method chaining
+     */
+    callerName(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_NAME_KEY, value);
+        return this;
+    }
+    /**
+     * Set the caller UPN baggage value.
+     * @param value The caller UPN
+     * @returns Self for method chaining
+     */
+    callerUpn(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_CALLER_UPN_KEY, value);
+        return this;
+    }
+    /**
+     * Set the conversation ID baggage value.
+     * @param value The conversation ID
+     * @returns Self for method chaining
+     */
+    conversationId(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the conversation item link baggage value.
+     * @param value The conversation item link
+     * @returns Self for method chaining
+     */
+    conversationItemLink(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY, value);
+        return this;
+    }
+    /**
+     * Set the execution source metadata ID (e.g., channel ID).
+     * @param value The source metadata ID
+     * @returns Self for method chaining
+     */
+    sourceMetadataId(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the execution source metadata name (e.g., channel name).
+     * @param value The source metadata name
+     * @returns Self for method chaining
+     */
+    sourceMetadataName(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_NAME_KEY, value);
+        return this;
+    }
+    /**
+     * Set the execution source metadata description (e.g., channel description).
+     * @param value The source metadata description
+     * @returns Self for method chaining
+     */
+    sourceMetadataDescription(value) {
+        this.set(constants_1.OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /**
+     * 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) {
+        if (!pairs) {
+            return this;
+        }
+        let entries;
+        if (Symbol.iterator in Object(pairs)) {
+            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 context manager that restores the previous baggage on exit
+     */
+    build() {
+        return new BaggageScope(this.pairs);
+    }
+    /**
+     * Add a baggage key/value if the value is not null or whitespace.
+     * @param key The baggage key
+     * @param value The baggage value
+     */
+    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
+     * @param correlationId The correlation ID
+     * @returns A context manager that restores the previous baggage on exit
+     */
+    static setRequestContext(tenantId, agentId, correlationId) {
+        return new BaggageBuilder()
+            .tenantId(tenantId)
+            .agentId(agentId)
+            .correlationId(correlationId)
+            .build();
+    }
+}
+exports.BaggageBuilder = BaggageBuilder;
+/**
+ * Context manager for baggage scope.
+ *
+ * This class manages the lifecycle of baggage values, setting them on enter
+ * and restoring the previous context on exit.
+ */
+class BaggageScope {
+    constructor(pairs) {
+        // 1. Start from current active context
+        const currentCtx = api_1.context.active();
+        // 2. Build merged baggage
+        let bag = api_1.propagation.getBaggage(currentCtx) ?? api_1.propagation.createBaggage({});
+        for (const [key, value] of pairs.entries()) {
+            if (value && value.trim()) {
+                bag = bag.setEntry(key, { value });
+            }
+        }
+        // 3. Create a new context that carries that baggage
+        this.contextWithBaggage = api_1.propagation.setBaggage(currentCtx, bag);
+    }
+    /**
+     * Execute a synchronous function under this baggage scope.
+     * Automatically restores previous context afterward.
+     */
+    run(fn) {
+        return api_1.context.with(this.contextWithBaggage, fn);
+    }
+    /**
+     * Dispose is a no-op because OpenTelemetry JS automatically restores
+     * the previous context after `context.with()` completes.
+     */
+    [Symbol.dispose]() {
+        // Nothing to detach manually; context restoration happens automatically.
+    }
+    /**
+     * Manual cleanup alternative if caller isn't using `using`.
+     */
+    dispose() {
+        this[Symbol.dispose]();
+    }
+}
+exports.BaggageScope = BaggageScope;
+//# sourceMappingURL=BaggageBuilder.js.map

package/dist/cjs/tracing/middleware/BaggageBuilder.js.map

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

package/dist/cjs/tracing/processors/SpanProcessor.d.ts

@@ -0,0 +1,30 @@
+import { Context, Span } from '@opentelemetry/api';
+import { SpanProcessor as BaseSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+/**
+ * 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.
+ */
+export declare class SpanProcessor 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=SpanProcessor.d.ts.map

package/dist/cjs/tracing/processors/SpanProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanProcessor.d.ts","sourceRoot":"","sources":["../../../../src/tracing/processors/SpanProcessor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAe,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAkElD;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}