@openai/agents-core 0.11.3 → 0.11.5

package/dist/tracing/context.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTracingContextStorage = setTracingContextStorage;
 exports.getCurrentTrace = getCurrentTrace;
 exports.getCurrentSpan = getCurrentSpan;
+exports.getCurrentTraceContext = getCurrentTraceContext;
+exports.withTraceContext = withTraceContext;
 exports.withTrace = withTrace;
 exports.getOrCreateTrace = getOrCreateTrace;
 exports.setCurrentSpan = setCurrentSpan;
@@ -26,7 +29,11 @@ function getContextAsyncLocalStorage() {
             return globalALS;
         }
         const newALS = new _shims_1.AsyncLocalStorage();
-        globalScope[ALS_SYMBOL] = newALS;
+        Object.defineProperty(globalScope, ALS_SYMBOL, {
+            value: newALS,
+            writable: true,
+            configurable: true,
+        });
         return newALS;
     }
     catch {
@@ -39,6 +46,31 @@ function getContextAsyncLocalStorage() {
         return localFallbackAls;
     }
 }
+/**
+ * Sets the context storage implementation used for tracing.
+ *
+ * Use this before starting traces in runtimes that cannot rely on the SDK's default
+ * AsyncLocalStorage implementation. Pass undefined to restore the default storage.
+ */
+function setTracingContextStorage(storage) {
+    try {
+        const globalScope = globalThis;
+        if (storage) {
+            Object.defineProperty(globalScope, ALS_SYMBOL, {
+                value: storage,
+                writable: true,
+                configurable: true,
+            });
+        }
+        else {
+            delete globalScope[ALS_SYMBOL];
+        }
+        localFallbackAls = undefined;
+    }
+    catch {
+        localFallbackAls = storage;
+    }
+}
 function getActiveContext() {
     const store = getContextAsyncLocalStorage().getStore();
     if (store?.active === true) {
@@ -46,6 +78,54 @@ function getActiveContext() {
     }
     return undefined;
 }
+function isPromiseLike(value) {
+    return ((typeof value === 'object' || typeof value === 'function') &&
+        value !== null &&
+        typeof value.then === 'function');
+}
+function deferRestoreForStreamedRunResult(result, restore) {
+    if (!(result instanceof result_1.StreamedRunResult)) {
+        return false;
+    }
+    const streamLoopPromise = result._getStreamLoopPromise();
+    if (!streamLoopPromise) {
+        return false;
+    }
+    void streamLoopPromise.then(restore, restore);
+    return true;
+}
+function restoreAfterResolvedValue(result, restore) {
+    if (!deferRestoreForStreamedRunResult(result, restore)) {
+        restore();
+    }
+    return result;
+}
+function runWithScopedTraceContext(store, fn) {
+    const asyncLocalStorage = getContextAsyncLocalStorage();
+    const previousStore = asyncLocalStorage.getStore();
+    const restore = () => {
+        asyncLocalStorage.enterWith(previousStore);
+    };
+    return asyncLocalStorage.run(store, () => {
+        let restoreOnExit = true;
+        try {
+            const result = fn();
+            restoreOnExit = false;
+            if (isPromiseLike(result)) {
+                return result.then((resolved) => restoreAfterResolvedValue(resolved, restore), (error) => {
+                    restore();
+                    throw error;
+                });
+            }
+            return restoreAfterResolvedValue(result, restore);
+        }
+        finally {
+            if (restoreOnExit) {
+                restore();
+            }
+        }
+    });
+}
 /**
  * This function will get the current trace from the execution context.
  *
@@ -70,6 +150,40 @@ function getCurrentSpan() {
     }
     return null;
 }
+/**
+ * Gets a public snapshot of the current trace context.
+ *
+ * This intentionally does not expose the internal async storage shape.
+ */
+function getCurrentTraceContext() {
+    const context = getActiveContext();
+    if (!context?.trace) {
+        return null;
+    }
+    if (context.span) {
+        return {
+            trace: context.trace,
+            span: context.span,
+        };
+    }
+    return { trace: context.trace };
+}
+/**
+ * Runs a callback with a previously captured trace context.
+ *
+ * Pass null or undefined to run the callback without any ambient trace context.
+ */
+function withTraceContext(context, fn) {
+    if (!context) {
+        return runWithScopedTraceContext({ active: false }, fn);
+    }
+    return runWithScopedTraceContext({
+        trace: context.trace,
+        span: context.span ?? undefined,
+        previousSpan: context.span?.previousSpan,
+        active: true,
+    }, fn);
+}
 /**
  * This is an AsyncLocalStorage instance that stores the current trace.
  * It will automatically handle the execution context of different event loop executions.

package/dist/tracing/context.js.map

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

package/dist/tracing/context.mjs

@@ -15,7 +15,11 @@ function getContextAsyncLocalStorage() {
             return globalALS;
         }
         const newALS = new AsyncLocalStorage();
-        globalScope[ALS_SYMBOL] = newALS;
+        Object.defineProperty(globalScope, ALS_SYMBOL, {
+            value: newALS,
+            writable: true,
+            configurable: true,
+        });
         return newALS;
     }
     catch {
@@ -28,6 +32,31 @@ function getContextAsyncLocalStorage() {
         return localFallbackAls;
     }
 }
+/**
+ * Sets the context storage implementation used for tracing.
+ *
+ * Use this before starting traces in runtimes that cannot rely on the SDK's default
+ * AsyncLocalStorage implementation. Pass undefined to restore the default storage.
+ */
+export function setTracingContextStorage(storage) {
+    try {
+        const globalScope = globalThis;
+        if (storage) {
+            Object.defineProperty(globalScope, ALS_SYMBOL, {
+                value: storage,
+                writable: true,
+                configurable: true,
+            });
+        }
+        else {
+            delete globalScope[ALS_SYMBOL];
+        }
+        localFallbackAls = undefined;
+    }
+    catch {
+        localFallbackAls = storage;
+    }
+}
 function getActiveContext() {
     const store = getContextAsyncLocalStorage().getStore();
     if (store?.active === true) {
@@ -35,6 +64,54 @@ function getActiveContext() {
     }
     return undefined;
 }
+function isPromiseLike(value) {
+    return ((typeof value === 'object' || typeof value === 'function') &&
+        value !== null &&
+        typeof value.then === 'function');
+}
+function deferRestoreForStreamedRunResult(result, restore) {
+    if (!(result instanceof StreamedRunResult)) {
+        return false;
+    }
+    const streamLoopPromise = result._getStreamLoopPromise();
+    if (!streamLoopPromise) {
+        return false;
+    }
+    void streamLoopPromise.then(restore, restore);
+    return true;
+}
+function restoreAfterResolvedValue(result, restore) {
+    if (!deferRestoreForStreamedRunResult(result, restore)) {
+        restore();
+    }
+    return result;
+}
+function runWithScopedTraceContext(store, fn) {
+    const asyncLocalStorage = getContextAsyncLocalStorage();
+    const previousStore = asyncLocalStorage.getStore();
+    const restore = () => {
+        asyncLocalStorage.enterWith(previousStore);
+    };
+    return asyncLocalStorage.run(store, () => {
+        let restoreOnExit = true;
+        try {
+            const result = fn();
+            restoreOnExit = false;
+            if (isPromiseLike(result)) {
+                return result.then((resolved) => restoreAfterResolvedValue(resolved, restore), (error) => {
+                    restore();
+                    throw error;
+                });
+            }
+            return restoreAfterResolvedValue(result, restore);
+        }
+        finally {
+            if (restoreOnExit) {
+                restore();
+            }
+        }
+    });
+}
 /**
  * This function will get the current trace from the execution context.
  *
@@ -59,6 +136,40 @@ export function getCurrentSpan() {
     }
     return null;
 }
+/**
+ * Gets a public snapshot of the current trace context.
+ *
+ * This intentionally does not expose the internal async storage shape.
+ */
+export function getCurrentTraceContext() {
+    const context = getActiveContext();
+    if (!context?.trace) {
+        return null;
+    }
+    if (context.span) {
+        return {
+            trace: context.trace,
+            span: context.span,
+        };
+    }
+    return { trace: context.trace };
+}
+/**
+ * Runs a callback with a previously captured trace context.
+ *
+ * Pass null or undefined to run the callback without any ambient trace context.
+ */
+export function withTraceContext(context, fn) {
+    if (!context) {
+        return runWithScopedTraceContext({ active: false }, fn);
+    }
+    return runWithScopedTraceContext({
+        trace: context.trace,
+        span: context.span ?? undefined,
+        previousSpan: context.span?.previousSpan,
+        active: true,
+    }, fn);
+}
 /**
  * This is an AsyncLocalStorage instance that stores the current trace.
  * It will automatically handle the execution context of different event loop executions.

package/dist/tracing/context.mjs.map

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

package/dist/tracing/index.d.ts

@@ -1,12 +1,18 @@
 import { TracingProcessor } from './processor';
 import type { TracingConfig } from './config';
-export { getCurrentSpan, getCurrentTrace, getOrCreateTrace, resetCurrentSpan, setCurrentSpan, withTrace, } from './context';
+import type { Span, SpanData } from './spans';
+import type { Trace } from './traces';
+import type { TracingIdGenerator } from './utils';
+export { getCurrentTraceContext, getCurrentSpan, getCurrentTrace, getOrCreateTrace, resetCurrentSpan, setCurrentSpan, setTracingContextStorage, withTraceContext, withTrace, } from './context';
+export type { TraceContextSnapshot, TracingContextStorage } from './context';
 export * from './createSpans';
-export { BatchTraceProcessor, TracingExporter, TracingProcessor, ConsoleSpanExporter, } from './processor';
+export { BatchTraceProcessor, TracingExporter, TracingProcessor, ConsoleSpanExporter, MultiTracingProcessor, } from './processor';
 export { NoopSpan, Span } from './spans';
 export type { SpanData, AgentSpanData, FunctionSpanData, GenerationUsageData, GenerationSpanData, ResponseSpanData, HandoffSpanData, CustomSpanData, GuardrailSpanData, TranscriptionSpanData, SpeechSpanData, SpeechGroupSpanData, MCPListToolsSpanData, SpanOptions, SpanError, } from './spans';
 export { NoopTrace, Trace } from './traces';
-export { generateGroupId, generateSpanId, generateTraceId } from './utils';
+export { defaultTracingIdGenerator, generateGroupId, generateSpanId, generateTraceId, } from './utils';
+export type { TracingIdGenerator } from './utils';
+export type { TraceProviderOptions } from './provider';
 export type { TracingConfig };
 /**
  * Add a processor to the list of processors. Each processor will receive all traces/spans.
@@ -26,6 +32,28 @@ export declare function setTraceProcessors(processors: TracingProcessor[]): void
  * @param disabled - Whether to disable tracing.
  */
 export declare function setTracingDisabled(disabled: boolean): void;
+/**
+ * Set the trace and span ID generator for the global tracing provider.
+ *
+ * @param idGenerator - Custom ID generator methods, or undefined to restore defaults.
+ */
+export declare function setTracingIdGenerator(idGenerator?: Partial<TracingIdGenerator>): void;
+/**
+ * Dispatch a completed trace lifecycle to all processors registered on the
+ * global tracing provider.
+ *
+ * This bypasses Trace.start() and Trace.end(), so callers can replay a
+ * completed lifecycle without mutating the trace state.
+ */
+export declare function dispatchTrace(trace: Trace): Promise<void>;
+/**
+ * Dispatch a completed span lifecycle to all processors registered on the
+ * global tracing provider.
+ *
+ * This bypasses Span.start() and Span.end(), so callers can replay a completed
+ * lifecycle without mutating existing timestamps.
+ */
+export declare function dispatchSpan<TSpanData extends SpanData>(span: Span<TSpanData>): Promise<void>;
 /**
  * Start the trace export loop.
  */

package/dist/tracing/index.js

@@ -14,23 +14,30 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateTraceId = exports.generateSpanId = exports.generateGroupId = exports.Trace = exports.NoopTrace = exports.Span = exports.NoopSpan = exports.ConsoleSpanExporter = exports.BatchTraceProcessor = exports.withTrace = exports.setCurrentSpan = exports.resetCurrentSpan = exports.getOrCreateTrace = exports.getCurrentTrace = exports.getCurrentSpan = void 0;
+exports.generateTraceId = exports.generateSpanId = exports.generateGroupId = exports.defaultTracingIdGenerator = exports.Trace = exports.NoopTrace = exports.Span = exports.NoopSpan = exports.MultiTracingProcessor = exports.ConsoleSpanExporter = exports.BatchTraceProcessor = exports.withTrace = exports.withTraceContext = exports.setTracingContextStorage = exports.setCurrentSpan = exports.resetCurrentSpan = exports.getOrCreateTrace = exports.getCurrentTrace = exports.getCurrentSpan = exports.getCurrentTraceContext = void 0;
 exports.addTraceProcessor = addTraceProcessor;
 exports.setTraceProcessors = setTraceProcessors;
 exports.setTracingDisabled = setTracingDisabled;
+exports.setTracingIdGenerator = setTracingIdGenerator;
+exports.dispatchTrace = dispatchTrace;
+exports.dispatchSpan = dispatchSpan;
 exports.startTraceExportLoop = startTraceExportLoop;
 const provider_1 = require("./provider.js");
 var context_1 = require("./context.js");
+Object.defineProperty(exports, "getCurrentTraceContext", { enumerable: true, get: function () { return context_1.getCurrentTraceContext; } });
 Object.defineProperty(exports, "getCurrentSpan", { enumerable: true, get: function () { return context_1.getCurrentSpan; } });
 Object.defineProperty(exports, "getCurrentTrace", { enumerable: true, get: function () { return context_1.getCurrentTrace; } });
 Object.defineProperty(exports, "getOrCreateTrace", { enumerable: true, get: function () { return context_1.getOrCreateTrace; } });
 Object.defineProperty(exports, "resetCurrentSpan", { enumerable: true, get: function () { return context_1.resetCurrentSpan; } });
 Object.defineProperty(exports, "setCurrentSpan", { enumerable: true, get: function () { return context_1.setCurrentSpan; } });
+Object.defineProperty(exports, "setTracingContextStorage", { enumerable: true, get: function () { return context_1.setTracingContextStorage; } });
+Object.defineProperty(exports, "withTraceContext", { enumerable: true, get: function () { return context_1.withTraceContext; } });
 Object.defineProperty(exports, "withTrace", { enumerable: true, get: function () { return context_1.withTrace; } });
 __exportStar(require("./createSpans.js"), exports);
 var processor_1 = require("./processor.js");
 Object.defineProperty(exports, "BatchTraceProcessor", { enumerable: true, get: function () { return processor_1.BatchTraceProcessor; } });
 Object.defineProperty(exports, "ConsoleSpanExporter", { enumerable: true, get: function () { return processor_1.ConsoleSpanExporter; } });
+Object.defineProperty(exports, "MultiTracingProcessor", { enumerable: true, get: function () { return processor_1.MultiTracingProcessor; } });
 var spans_1 = require("./spans.js");
 Object.defineProperty(exports, "NoopSpan", { enumerable: true, get: function () { return spans_1.NoopSpan; } });
 Object.defineProperty(exports, "Span", { enumerable: true, get: function () { return spans_1.Span; } });
@@ -38,6 +45,7 @@ var traces_1 = require("./traces.js");
 Object.defineProperty(exports, "NoopTrace", { enumerable: true, get: function () { return traces_1.NoopTrace; } });
 Object.defineProperty(exports, "Trace", { enumerable: true, get: function () { return traces_1.Trace; } });
 var utils_1 = require("./utils.js");
+Object.defineProperty(exports, "defaultTracingIdGenerator", { enumerable: true, get: function () { return utils_1.defaultTracingIdGenerator; } });
 Object.defineProperty(exports, "generateGroupId", { enumerable: true, get: function () { return utils_1.generateGroupId; } });
 Object.defineProperty(exports, "generateSpanId", { enumerable: true, get: function () { return utils_1.generateSpanId; } });
 Object.defineProperty(exports, "generateTraceId", { enumerable: true, get: function () { return utils_1.generateTraceId; } });
@@ -65,6 +73,34 @@ function setTraceProcessors(processors) {
 function setTracingDisabled(disabled) {
     (0, provider_1.getGlobalTraceProvider)().setDisabled(disabled);
 }
+/**
+ * Set the trace and span ID generator for the global tracing provider.
+ *
+ * @param idGenerator - Custom ID generator methods, or undefined to restore defaults.
+ */
+function setTracingIdGenerator(idGenerator) {
+    (0, provider_1.getGlobalTraceProvider)().setIdGenerator(idGenerator);
+}
+/**
+ * Dispatch a completed trace lifecycle to all processors registered on the
+ * global tracing provider.
+ *
+ * This bypasses Trace.start() and Trace.end(), so callers can replay a
+ * completed lifecycle without mutating the trace state.
+ */
+async function dispatchTrace(trace) {
+    await (0, provider_1.getGlobalTraceProvider)().dispatchTrace(trace);
+}
+/**
+ * Dispatch a completed span lifecycle to all processors registered on the
+ * global tracing provider.
+ *
+ * This bypasses Span.start() and Span.end(), so callers can replay a completed
+ * lifecycle without mutating existing timestamps.
+ */
+async function dispatchSpan(span) {
+    await (0, provider_1.getGlobalTraceProvider)().dispatchSpan(span);
+}
 /**
  * Start the trace export loop.
  */

package/dist/tracing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA8CA,8CAEC;AAOD,gDAEC;AAOD,gDAEC;AAKD,oDAEC;AAxED,4CAAoD;AAGpD,wCAOmB;AANjB,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,2GAAA,gBAAgB,OAAA;AAChB,2GAAA,gBAAgB,OAAA;AAChB,yGAAA,cAAc,OAAA;AACd,oGAAA,SAAS,OAAA;AAEX,mDAA8B;AAC9B,4CAKqB;AAJnB,gHAAA,mBAAmB,OAAA;AAGnB,gHAAA,mBAAmB,OAAA;AAErB,oCAAyC;AAAhC,iGAAA,QAAQ,OAAA;AAAE,6FAAA,IAAI,OAAA;AAkBvB,sCAA4C;AAAnC,mGAAA,SAAS,OAAA;AAAE,+FAAA,KAAK,OAAA;AACzB,oCAA2E;AAAlE,wGAAA,eAAe,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,wGAAA,eAAe,OAAA;AAGzD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,SAA2B;IAC3D,IAAA,iCAAsB,GAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,UAA8B;IAC/D,IAAA,iCAAsB,GAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAiB;IAClD,IAAA,iCAAsB,GAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,IAAA,iCAAsB,GAAE,CAAC,eAAe,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA6DA,8CAEC;AAOD,gDAEC;AAOD,gDAEC;AAOD,sDAIC;AASD,sCAEC;AASD,oCAIC;AAKD,oDAEC;AA1HD,4CAAoD;AAMpD,wCAUmB;AATjB,iHAAA,sBAAsB,OAAA;AACtB,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,2GAAA,gBAAgB,OAAA;AAChB,2GAAA,gBAAgB,OAAA;AAChB,yGAAA,cAAc,OAAA;AACd,mHAAA,wBAAwB,OAAA;AACxB,2GAAA,gBAAgB,OAAA;AAChB,oGAAA,SAAS,OAAA;AAGX,mDAA8B;AAC9B,4CAMqB;AALnB,gHAAA,mBAAmB,OAAA;AAGnB,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AAEvB,oCAAyC;AAAhC,iGAAA,QAAQ,OAAA;AAAE,6FAAA,IAAI,OAAA;AAkBvB,sCAA4C;AAAnC,mGAAA,SAAS,OAAA;AAAE,+FAAA,KAAK,OAAA;AACzB,oCAKiB;AAJf,kHAAA,yBAAyB,OAAA;AACzB,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AAMjB;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,SAA2B;IAC3D,IAAA,iCAAsB,GAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,UAA8B;IAC/D,IAAA,iCAAsB,GAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAiB;IAClD,IAAA,iCAAsB,GAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,WAAyC;IAEzC,IAAA,iCAAsB,GAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CAAC,KAAY;IAC9C,MAAM,IAAA,iCAAsB,GAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAChC,IAAqB;IAErB,MAAM,IAAA,iCAAsB,GAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,IAAA,iCAAsB,GAAE,CAAC,eAAe,EAAE,CAAC;AAC7C,CAAC"}

package/dist/tracing/index.mjs

@@ -1,10 +1,10 @@
 import { getGlobalTraceProvider } from "./provider.mjs";
-export { getCurrentSpan, getCurrentTrace, getOrCreateTrace, resetCurrentSpan, setCurrentSpan, withTrace, } from "./context.mjs";
+export { getCurrentTraceContext, getCurrentSpan, getCurrentTrace, getOrCreateTrace, resetCurrentSpan, setCurrentSpan, setTracingContextStorage, withTraceContext, withTrace, } from "./context.mjs";
 export * from "./createSpans.mjs";
-export { BatchTraceProcessor, ConsoleSpanExporter, } from "./processor.mjs";
+export { BatchTraceProcessor, ConsoleSpanExporter, MultiTracingProcessor, } from "./processor.mjs";
 export { NoopSpan, Span } from "./spans.mjs";
 export { NoopTrace, Trace } from "./traces.mjs";
-export { generateGroupId, generateSpanId, generateTraceId } from "./utils.mjs";
+export { defaultTracingIdGenerator, generateGroupId, generateSpanId, generateTraceId, } from "./utils.mjs";
 /**
  * Add a processor to the list of processors. Each processor will receive all traces/spans.
  *
@@ -29,6 +29,34 @@ export function setTraceProcessors(processors) {
 export function setTracingDisabled(disabled) {
     getGlobalTraceProvider().setDisabled(disabled);
 }
+/**
+ * Set the trace and span ID generator for the global tracing provider.
+ *
+ * @param idGenerator - Custom ID generator methods, or undefined to restore defaults.
+ */
+export function setTracingIdGenerator(idGenerator) {
+    getGlobalTraceProvider().setIdGenerator(idGenerator);
+}
+/**
+ * Dispatch a completed trace lifecycle to all processors registered on the
+ * global tracing provider.
+ *
+ * This bypasses Trace.start() and Trace.end(), so callers can replay a
+ * completed lifecycle without mutating the trace state.
+ */
+export async function dispatchTrace(trace) {
+    await getGlobalTraceProvider().dispatchTrace(trace);
+}
+/**
+ * Dispatch a completed span lifecycle to all processors registered on the
+ * global tracing provider.
+ *
+ * This bypasses Span.start() and Span.end(), so callers can replay a completed
+ * lifecycle without mutating existing timestamps.
+ */
+export async function dispatchSpan(span) {
+    await getGlobalTraceProvider().dispatchSpan(span);
+}
 /**
  * Start the trace export loop.
  */

package/dist/tracing/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"OACO,EAAE,sBAAsB,EAAE;OAG1B,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,SAAS,GACV;;OAEM,EACL,mBAAmB,EAGnB,mBAAmB,GACpB;OACM,EAAE,QAAQ,EAAE,IAAI,EAAE;OAkBlB,EAAE,SAAS,EAAE,KAAK,EAAE;OACpB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE;AAG3D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA2B;IAC3D,sBAAsB,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA8B;IAC/D,sBAAsB,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,sBAAsB,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,sBAAsB,EAAE,CAAC,eAAe,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"OACO,EAAE,sBAAsB,EAAE;OAM1B,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,gBAAgB,EAChB,SAAS,GACV;;OAGM,EACL,mBAAmB,EAGnB,mBAAmB,EACnB,qBAAqB,GACtB;OACM,EAAE,QAAQ,EAAE,IAAI,EAAE;OAkBlB,EAAE,SAAS,EAAE,KAAK,EAAE;OACpB,EACL,yBAAyB,EACzB,eAAe,EACf,cAAc,EACd,eAAe,GAChB;AAKD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA2B;IAC3D,sBAAsB,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA8B;IAC/D,sBAAsB,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,sBAAsB,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAyC;IAEzC,sBAAsB,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAY;IAC9C,MAAM,sBAAsB,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAqB;IAErB,MAAM,sBAAsB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,sBAAsB,EAAE,CAAC,eAAe,EAAE,CAAC;AAC7C,CAAC"}

package/dist/tracing/processor.d.ts

@@ -91,6 +91,16 @@ export declare class MultiTracingProcessor implements TracingProcessor {
     onTraceEnd(trace: Trace): Promise<void>;
     onSpanStart(span: Span): Promise<void>;
     onSpanEnd(span: Span): Promise<void>;
+    /**
+     * Dispatches a completed trace lifecycle to every registered processor without
+     * calling Trace.start() or Trace.end().
+     */
+    dispatchTrace(trace: Trace): Promise<void>;
+    /**
+     * Dispatches a completed span lifecycle to every registered processor without
+     * calling Span.start() or Span.end().
+     */
+    dispatchSpan(span: Span): Promise<void>;
     shutdown(timeout?: number): Promise<void>;
     forceFlush(): Promise<void>;
 }