@respan/tracing 1.1.5 → 1.2.0

package/dist/processor/manager.d.ts

@@ -1,5 +1,6 @@
 import { Context } from "@opentelemetry/api";
 import { SpanProcessor, ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import { type RespanSpanNameStyle } from "@respan/respan-sdk";
 /**
  * Configuration for a processor
  */
@@ -12,6 +13,14 @@ export interface ProcessorConfig {
     filter?: (span: ReadableSpan) => boolean;
     /** Optional priority (higher = processed first) */
     priority?: number;
+    /** Send spans immediately without batching. Useful for short-lived scripts. */
+    disableBatch?: boolean;
+}
+export interface MultiProcessorManagerOptions {
+    /** Send spans immediately without batching. Useful for short-lived scripts. */
+    disableBatch?: boolean;
+    /** Exported span.name style: "semantic" (default) or "legacy". */
+    spanNameStyle?: RespanSpanNameStyle | string;
 }
 /**
  * Manager for multiple span processors with routing capabilities.
@@ -40,7 +49,10 @@ export interface ProcessorConfig {
  * ```
  */
 export declare class MultiProcessorManager implements SpanProcessor {
+    private readonly options;
     private processors;
+    private readonly spanNameStyle;
+    constructor(options?: MultiProcessorManagerOptions);
     /**
      * Add a new processor with routing configuration
      * @param config - Processor configuration

package/dist/processor/manager.js

@@ -1,5 +1,6 @@
-import { BatchSpanProcessor, } from "@opentelemetry/sdk-trace-base";
-import { RespanSpanAttributes } from "@respan/respan-sdk";
+import { BatchSpanProcessor, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+import { RespanSpanAttributes, } from "@respan/respan-sdk";
+import { resolveSpanNameStyle, SpanNameTransformingExporter, } from "./spanName.js";
 /**
  * Manager for multiple span processors with routing capabilities.
  *
@@ -27,13 +28,23 @@ import { RespanSpanAttributes } from "@respan/respan-sdk";
  * ```
  */
 export class MultiProcessorManager {
+    options;
     processors = [];
+    spanNameStyle;
+    constructor(options = {}) {
+        this.options = options;
+        this.spanNameStyle = resolveSpanNameStyle(options.spanNameStyle);
+    }
     /**
      * Add a new processor with routing configuration
      * @param config - Processor configuration
      */
     addProcessor(config) {
-        const processor = new BatchSpanProcessor(config.exporter);
+        const exporter = new SpanNameTransformingExporter(config.exporter, this.spanNameStyle);
+        const disableBatch = config.disableBatch ?? this.options.disableBatch ?? false;
+        const processor = disableBatch
+            ? new SimpleSpanProcessor(exporter)
+            : new BatchSpanProcessor(exporter);
         // Insert in priority order (higher priority first)
         const priority = config.priority ?? 0;
         const insertIndex = this.processors.findIndex((p) => (p.config.priority ?? 0) < priority);
@@ -43,7 +54,7 @@ export class MultiProcessorManager {
         else {
             this.processors.splice(insertIndex, 0, { processor, config });
         }
-        console.debug(`[Respan] Added processor "${config.name}" with priority ${priority}`);
+        console.debug(`[Respan] Added processor "${config.name}" with priority ${priority} (${disableBatch ? "simple" : "batch"} mode)`);
     }
     /**
      * Get all configured processors

package/dist/processor/manager.js.map

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

package/dist/processor/spanName.d.ts

@@ -0,0 +1,15 @@
+import type { ExportResult } from "@opentelemetry/core";
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import { type RespanSpanNameStyle } from "@respan/respan-sdk";
+export declare function resolveSpanNameStyle(value?: RespanSpanNameStyle | string): RespanSpanNameStyle;
+export declare function transformReadableSpanName(span: ReadableSpan, style: RespanSpanNameStyle | string | undefined): ReadableSpan;
+export declare function semanticSpanNameForSpan(span: ReadableSpan): string;
+export declare function transformReadableSpanBatch(spans: ReadableSpan[], style: RespanSpanNameStyle | string | undefined): ReadableSpan[];
+export declare class SpanNameTransformingExporter implements SpanExporter {
+    private readonly delegate;
+    private readonly style;
+    constructor(delegate: SpanExporter, style: RespanSpanNameStyle);
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}

package/dist/processor/spanName.js

@@ -0,0 +1,305 @@
+import { SpanAttributes, TraceloopSpanKindValues, } from "@traceloop/ai-semantic-conventions";
+import { RespanLogType, RespanSpanAttributes, } from "@respan/respan-sdk";
+const INTERNAL_KIND_ATTR = RespanSpanAttributes.RESPAN_INTERNAL_SPAN_NAME_KIND;
+const INTERNAL_DETAIL_ATTR = RespanSpanAttributes.RESPAN_INTERNAL_SPAN_NAME_DETAIL;
+const INTERNAL_DROP_ATTR = RespanSpanAttributes.RESPAN_INTERNAL_DROP_SPAN;
+const INTERNAL_EXPORT_PARENT_ATTR = RespanSpanAttributes.RESPAN_INTERNAL_EXPORT_PARENT;
+const INTERNAL_SPAN_NAME_ATTRS = [
+    INTERNAL_KIND_ATTR,
+    INTERNAL_DETAIL_ATTR,
+    INTERNAL_DROP_ATTR,
+    INTERNAL_EXPORT_PARENT_ATTR,
+];
+const SUFFIXED_OPERATIONS = new Set(["agent", "tool", "handoff", "llm"]);
+// Operation/structural tokens that must not survive as a semantic-name suffix
+// (e.g. "handoff.task" or "llm.doGenerate" — the suffix carries no identity).
+const GENERIC_DETAIL_TOKENS = new Set([
+    "agent",
+    "chat",
+    "completion",
+    "completions",
+    "doembed",
+    "dogenerate",
+    "dostream",
+    "embedding",
+    "generate",
+    "generation",
+    "guardrail",
+    "handoff",
+    "llm",
+    "response",
+    "responses",
+    "task",
+    "text",
+    "tool",
+    "workflow",
+]);
+export function resolveSpanNameStyle(value) {
+    // Normalize like the Python resolver (.strip().lower()) so the same env
+    // value means the same thing in a mixed-language deployment.
+    const normalized = value === undefined || value === null ? "" : String(value).trim().toLowerCase();
+    return normalized === "legacy" ? "legacy" : "semantic";
+}
+export function transformReadableSpanName(span, style) {
+    const resolvedStyle = resolveSpanNameStyle(style);
+    const attrs = span.attributes;
+    const attributes = stripInternalSemanticNameAttrs(attrs);
+    const name = resolvedStyle === "semantic" ? semanticSpanNameForSpan(span) : span.name;
+    // The export-parent attr distinguishes "absent" (leave the parent alone)
+    // from "" (the dropped wrapper was a root span — promote the child to root).
+    let reparent;
+    if (resolvedStyle === "semantic") {
+        const raw = attrs[INTERNAL_EXPORT_PARENT_ATTR];
+        if (raw !== undefined && raw !== null) {
+            const text = String(raw).trim();
+            reparent = text === "" ? null : text;
+        }
+    }
+    if (name === span.name &&
+        attributes === span.attributes &&
+        reparent === undefined) {
+        return span;
+    }
+    return cloneReadableSpan(span, name, attributes, reparent);
+}
+export function semanticSpanNameForSpan(span) {
+    const attrs = span.attributes;
+    const operation = resolveOperation(attrs, span.name);
+    // Spans with no recognizable operation keep their original name — the
+    // semantic style renames known operations, it never destroys pass-through
+    // span names (matches the Python exporter).
+    if (!operation) {
+        return span.name;
+    }
+    const detail = resolveDetail(attrs, span.name, operation);
+    const hasInternalHint = attrs[INTERNAL_KIND_ATTR] !== undefined || attrs[INTERNAL_DETAIL_ATTR] !== undefined;
+    if (!SUFFIXED_OPERATIONS.has(operation)) {
+        return operation;
+    }
+    if (operation === "llm") {
+        return detail ? `${operation}.${detail}` : operation;
+    }
+    if (!hasInternalHint && span.name.startsWith(`${operation}.`)) {
+        const existingDetail = span.name.slice(operation.length + 1);
+        if (existingDetail && !GENERIC_DETAIL_TOKENS.has(existingDetail.toLowerCase())) {
+            return span.name;
+        }
+    }
+    if (!detail || detail.toLowerCase() === operation) {
+        return operation;
+    }
+    return `${operation}.${detail}`;
+}
+export function transformReadableSpanBatch(spans, style) {
+    const resolvedStyle = resolveSpanNameStyle(style);
+    // Dropping and reparenting are per-span decisions driven entirely by
+    // attributes the owning instrumentation stamped at span start
+    // (respan.internal.drop_span on the wrapper, export_parent_span_id on its
+    // children) — no cross-span state, so batch boundaries cannot break trees.
+    // Legacy style preserves the emitted tree exactly.
+    if (resolvedStyle === "legacy") {
+        return spans.map((span) => transformReadableSpanName(span, resolvedStyle));
+    }
+    return spans.flatMap((span) => {
+        const attrs = span.attributes;
+        if (attrs[INTERNAL_DROP_ATTR] === true || attrs[INTERNAL_DROP_ATTR] === "true") {
+            return [];
+        }
+        return [transformReadableSpanName(span, resolvedStyle)];
+    });
+}
+export class SpanNameTransformingExporter {
+    delegate;
+    style;
+    constructor(delegate, style) {
+        this.delegate = delegate;
+        this.style = style;
+    }
+    export(spans, resultCallback) {
+        this.delegate.export(transformReadableSpanBatch(spans, this.style), resultCallback);
+    }
+    shutdown() {
+        return this.delegate.shutdown();
+    }
+    forceFlush() {
+        const maybeFlush = this.delegate
+            .forceFlush;
+        return maybeFlush ? maybeFlush.call(this.delegate) : Promise.resolve();
+    }
+}
+function stripInternalSemanticNameAttrs(attrs) {
+    let next;
+    for (const key of INTERNAL_SPAN_NAME_ATTRS) {
+        if (attrs[key] !== undefined) {
+            next ??= { ...attrs };
+            delete next[key];
+        }
+    }
+    return next ?? attrs;
+}
+function cloneReadableSpan(span, name, attributes, 
+// string = new parent id; null = promote to root; undefined = leave as-is
+reparent) {
+    const clone = Object.create(Object.getPrototypeOf(span));
+    Object.assign(clone, span);
+    Object.defineProperty(clone, "name", {
+        value: name,
+        enumerable: true,
+        configurable: true,
+    });
+    Object.defineProperty(clone, "attributes", {
+        value: attributes,
+        enumerable: true,
+        configurable: true,
+    });
+    if (reparent !== undefined) {
+        // OTel SDK 1.x exposes parentSpanId on ReadableSpan; revisit for SDK 2.x
+        // (parentSpanContext) when the workspace upgrades.
+        Object.defineProperty(clone, "parentSpanId", {
+            value: reparent === null ? undefined : reparent,
+            enumerable: true,
+            configurable: true,
+        });
+    }
+    return clone;
+}
+function resolveOperation(attrs, spanName) {
+    // An explicit instrumentation hint always wins — even an unrecognized value
+    // is used (lowercased + sanitized, prefixes are lowercase by contract),
+    // since it states intent.
+    const hintedKind = stringAttr(attrs, INTERNAL_KIND_ATTR);
+    if (hintedKind) {
+        return mapOperation(hintedKind) ?? sanitizeNamePart(hintedKind.toLowerCase(), "span");
+    }
+    // Log type before span kind, matching the Python exporter's priority.
+    const logType = stringAttr(attrs, RespanSpanAttributes.RESPAN_LOG_TYPE);
+    if (logType) {
+        const mapped = mapOperation(logType);
+        if (mapped)
+            return mapped;
+    }
+    const tlKind = stringAttr(attrs, SpanAttributes.TRACELOOP_SPAN_KIND);
+    if (tlKind) {
+        const mapped = mapOperation(tlKind);
+        if (mapped)
+            return mapped;
+    }
+    return inferOperationFromName(spanName);
+}
+function resolveDetail(attrs, spanName, operation) {
+    if (operation === "llm") {
+        const model = resolveLlmModel(attrs);
+        return model ? sanitizeNamePart(model, "") : "";
+    }
+    const hintedDetail = stringAttr(attrs, INTERNAL_DETAIL_ATTR);
+    if (hintedDetail) {
+        return sanitizeNamePart(hintedDetail, "");
+    }
+    const entityName = stringAttr(attrs, SpanAttributes.TRACELOOP_ENTITY_NAME);
+    if (entityName) {
+        return sanitizeNamePart(entityName, "");
+    }
+    const rawDetail = detailFromRawName(spanName, operation);
+    if (rawDetail && GENERIC_DETAIL_TOKENS.has(rawDetail.toLowerCase())) {
+        return "";
+    }
+    return sanitizeNamePart(rawDetail, "");
+}
+function resolveLlmModel(attrs) {
+    return firstStringAttr(attrs, [
+        RespanSpanAttributes.GEN_AI_REQUEST_MODEL,
+        RespanSpanAttributes.OPENINFERENCE_LLM_MODEL_NAME,
+        "llm.model_name",
+        "model",
+        SpanAttributes.LLM_REQUEST_MODEL,
+    ]);
+}
+function firstStringAttr(attrs, keys) {
+    for (const key of keys) {
+        const value = stringAttr(attrs, key);
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+function stringAttr(attrs, key) {
+    const value = attrs[key];
+    if (value === undefined || value === null)
+        return undefined;
+    const text = String(value).trim();
+    return text || undefined;
+}
+/** Map a kind/log-type token to a semantic operation; undefined when unknown. */
+function mapOperation(value) {
+    const normalized = value.toLowerCase();
+    switch (normalized) {
+        case TraceloopSpanKindValues.WORKFLOW:
+        case RespanLogType.WORKFLOW:
+            return "workflow";
+        case TraceloopSpanKindValues.AGENT:
+        case RespanLogType.AGENT:
+            return "agent";
+        case TraceloopSpanKindValues.TASK:
+        case RespanLogType.TASK:
+            return "task";
+        case TraceloopSpanKindValues.TOOL:
+        case RespanLogType.TOOL:
+            return "tool";
+        case RespanLogType.FUNCTION:
+            return "tool";
+        case RespanLogType.HANDOFF:
+            return "handoff";
+        case RespanLogType.GUARDRAIL:
+            return "guardrail";
+        case RespanLogType.EMBEDDING:
+        case "embed":
+            return "embedding";
+        case RespanLogType.TRANSCRIPTION:
+            return "transcribe";
+        case RespanLogType.SPEECH:
+            return "speech";
+        case RespanLogType.CHAT:
+        case RespanLogType.TEXT:
+        case RespanLogType.RESPONSE:
+        case RespanLogType.GENERATION:
+        case "completion":
+        case "completions":
+        case "generate":
+        case "llm":
+            return "llm";
+        default:
+            // Unknown values (including "custom"/"unknown" log types) resolve to no
+            // operation so the caller preserves the original span name.
+            return undefined;
+    }
+}
+function inferOperationFromName(spanName) {
+    const suffix = spanName.split(".").at(-1);
+    if (suffix && GENERIC_DETAIL_TOKENS.has(suffix.toLowerCase())) {
+        return mapOperation(suffix);
+    }
+    return undefined;
+}
+function detailFromRawName(spanName, operation) {
+    if (spanName.endsWith(`.${operation}`)) {
+        return spanName.slice(0, -(operation.length + 1));
+    }
+    if (spanName.startsWith(`${operation}.`)) {
+        return spanName.slice(operation.length + 1);
+    }
+    if (operation === "handoff") {
+        return spanName.replace(/^handoff\s*[:.-]?\s*/i, "");
+    }
+    return spanName;
+}
+function sanitizeNamePart(value, fallback) {
+    // \p{L}\p{N} keeps unicode letters/digits so non-ASCII agent/tool names
+    // survive — parity with Python's unicode \w.
+    const sanitized = value
+        .trim()
+        .replace(/\s*(?:→|->)\s*/g, "_")
+        .replace(/[^\p{L}\p{N}_.-]+/gu, "_")
+        .replace(/^[_\-.]+|[_\-.]+$/g, "");
+    return sanitized || fallback;
+}
+//# sourceMappingURL=spanName.js.map

package/dist/processor/spanName.js.map

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

package/dist/types/clientTypes.d.ts

@@ -1,5 +1,6 @@
 import { SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { TextMapPropagator, ContextManager } from "@opentelemetry/api";
+import type { RespanSpanNameStyle } from "@respan/respan-sdk";
 /**
  * Available instrumentation names for consistent camelCase naming.
  * Abbreviations like AI, API, DB are kept uppercase.
@@ -17,6 +18,8 @@ export interface ProcessorConfig {
     filter?: (span: any) => boolean;
     /** Optional priority (higher = processed first) */
     priority?: number;
+    /** Send spans immediately without batching. Useful for short-lived scripts. */
+    disableBatch?: boolean;
 }
 /**
  * Options for initializing the Respan SDK.
@@ -86,6 +89,13 @@ export interface RespanOptions {
      * Defaults to true.
      */
     tracingEnabled?: boolean;
+    /**
+     * Controls exported span.name formatting.
+     * - semantic: use operation-prefixed names like agent.triage or llm.gpt-4o
+     * - legacy: preserve instrumentation span names
+     * Defaults to semantic. Can also be set with RESPAN_SPAN_NAME_STYLE=legacy.
+     */
+    spanNameStyle?: RespanSpanNameStyle;
     /**
      * Additional resource attributes to attach to all spans. Optional.
      * Useful for adding environment, version, region, etc.

package/dist/types/clientTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"clientTypes.js","sourceRoot":"","sources":["../../src/types/clientTypes.ts"],"names":[],"mappings":"AAmNA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChD,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,IAAI,6BAA6B,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChD;QACI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ"}
+{"version":3,"file":"clientTypes.js","sourceRoot":"","sources":["../../src/types/clientTypes.ts"],"names":[],"mappings":"AA8NA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChD,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,IAAI,6BAA6B,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChD;QACI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ"}

package/dist/utils/client.js

@@ -90,9 +90,8 @@ class RespanClientImpl {
         return currentSpan.isRecording();
     }
     async flush() {
-        // Import forceFlush from tracing utils
-        const { forceFlush } = await import("./tracing.js");
-        await forceFlush();
+        const { flush } = await import("./tracing.js");
+        await flush();
     }
 }
 // Singleton instance

package/dist/utils/client.js.map

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

package/dist/utils/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./context.js";
 export * from "./span.js";
 export * from "./spanFactory.js";
-export { startTracing, forceFlush, _resolveBaseURL } from "./tracing.js";
+export { startTracing, flush, forceFlush, shutdownTracing, _resolveBaseURL } from "./tracing.js";
 export * from "./client.js";
 export * from "./spanBuffer.js";

package/dist/utils/index.js

@@ -2,7 +2,7 @@ export * from "./context.js";
 export * from "./span.js";
 export * from "./spanFactory.js";
 // Export tracing utils but avoid naming conflicts
-export { startTracing, forceFlush, _resolveBaseURL } from "./tracing.js";
+export { startTracing, flush, forceFlush, shutdownTracing, _resolveBaseURL } from "./tracing.js";
 // Export client and span buffer
 export * from "./client.js";
 export * from "./spanBuffer.js";

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AAEjC,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzE,gCAAgC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AAEjC,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEjG,gCAAgC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/utils/tracing.d.ts

@@ -13,9 +13,17 @@ export declare const _resolveBaseURL: (baseURL: string) => string;
  */
 export declare const startTracing: (options: RespanOptions) => Promise<void>;
 /**
- * Enhanced error logging for forceFlush
+ * Flush pending spans without shutting down the SDK.
+ */
+export declare const flush: () => Promise<void>;
+/**
+ * Backward-compatible alias for flushing pending spans.
  */
 export declare const forceFlush: () => Promise<void>;
+/**
+ * Flush pending spans and shut down the SDK.
+ */
+export declare const shutdownTracing: () => Promise<void>;
 /**
  * Gets the current SDK instance.
  * Useful for advanced configuration or checking if tracing is initialized.