@openai/agents-core 0.4.0 → 0.4.2

package/dist/runner/tracing.d.ts

@@ -3,6 +3,15 @@ import { Handoff } from '../handoff';
 import { ModelTracing } from '../model';
 import { Tool } from '../tool';
 import { createAgentSpan } from '../tracing';
+import { Span } from '../tracing/spans';
+import { Trace } from '../tracing/traces';
+export type TraceOverrideConfig = {
+    traceId?: string;
+    workflowName?: string;
+    groupId?: string;
+    traceMetadata?: Record<string, any>;
+    tracingApiKey?: string;
+};
 type EnsureAgentSpanParams<TContext> = {
     agent: Agent<TContext, any>;
     handoffs: Handoff<any, any>[];
@@ -15,9 +24,13 @@ type EnsureAgentSpanParams<TContext> = {
  * `'enabled_without_data'` to omit sensitive content while still emitting spans.
  */
 export declare function getTracing(tracingDisabled: boolean, traceIncludeSensitiveData: boolean): ModelTracing;
+export declare function applyTraceOverrides(trace: Trace, currentSpan: Span<any> | undefined, overrides: TraceOverrideConfig): {
+    trace: Trace;
+    currentSpan: Span<any> | undefined;
+};
 /**
  * Ensures an agent span exists and updates tool metadata if already present.
  * Returns the span so callers can pass it through run state.
  */
-export declare function ensureAgentSpan<TContext>(params: EnsureAgentSpanParams<TContext>): import("../tracing").Span<import("../tracing").AgentSpanData>;
+export declare function ensureAgentSpan<TContext>(params: EnsureAgentSpanParams<TContext>): Span<import("../tracing").AgentSpanData>;
 export {};

package/dist/runner/tracing.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTracing = getTracing;
+exports.applyTraceOverrides = applyTraceOverrides;
 exports.ensureAgentSpan = ensureAgentSpan;
 const context_1 = require("../tracing/context.js");
 const tracing_1 = require("../tracing/index.js");
+const provider_1 = require("../tracing/provider.js");
 /**
  * Normalizes tracing configuration into the format expected by model providers.
  * Returns `false` to disable tracing, `true` to include full payload data, or
@@ -18,6 +20,47 @@ function getTracing(tracingDisabled, traceIncludeSensitiveData) {
     }
     return 'enabled_without_data';
 }
+function rebaseSpanChain(span, trace) {
+    const previousSpan = span.previousSpan
+        ? rebaseSpanChain(span.previousSpan, trace)
+        : undefined;
+    const parent = previousSpan ?? trace;
+    const rebasedSpan = (0, provider_1.getGlobalTraceProvider)().createSpan({
+        spanId: span.spanId,
+        parentId: span.parentId ?? undefined,
+        startedAt: span.startedAt ?? undefined,
+        endedAt: span.endedAt ?? undefined,
+        data: span.spanData,
+        error: span.error ?? undefined,
+        tracingApiKey: span.tracingApiKey,
+    }, parent);
+    rebasedSpan.previousSpan = previousSpan;
+    return rebasedSpan;
+}
+function applyTraceOverrides(trace, currentSpan, overrides) {
+    const traceIdOverride = overrides.traceId !== undefined && overrides.traceId !== trace.traceId;
+    const tracingApiKeyOverride = overrides.tracingApiKey !== undefined &&
+        overrides.tracingApiKey !== trace.tracingApiKey;
+    if (overrides.traceId !== undefined) {
+        trace.traceId = overrides.traceId;
+    }
+    if (overrides.workflowName !== undefined) {
+        trace.name = overrides.workflowName;
+    }
+    if (overrides.groupId !== undefined) {
+        trace.groupId = overrides.groupId ?? null;
+    }
+    if (overrides.traceMetadata !== undefined) {
+        trace.metadata = overrides.traceMetadata;
+    }
+    if (overrides.tracingApiKey !== undefined) {
+        trace.tracingApiKey = overrides.tracingApiKey;
+    }
+    if (currentSpan && (traceIdOverride || tracingApiKeyOverride)) {
+        return { trace, currentSpan: rebaseSpanChain(currentSpan, trace) };
+    }
+    return { trace, currentSpan };
+}
 /**
  * Ensures an agent span exists and updates tool metadata if already present.
  * Returns the span so callers can pass it through run state.

package/dist/runner/tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/runner/tracing.ts"],"names":[],"mappings":";;AAmBA,gCAaC;AAMD,0CAsBC;AAxDD,mDAAoD;AACpD,iDAA6C;AAS7C;;;;GAIG;AACH,SAAgB,UAAU,CACxB,eAAwB,EACxB,yBAAkC;IAElC,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,yBAAyB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC7B,MAAuC;IAEvC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvD,MAAM,YAAY,GAAG,WAAW,CAAC;IACjC,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAA,yBAAe,EAAC;QAC3B,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/B,WAAW,EAAE,KAAK,CAAC,gBAAgB;SACpC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACb,IAAA,wBAAc,EAAC,IAAI,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/runner/tracing.ts"],"names":[],"mappings":"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"}

package/dist/runner/tracing.mjs

@@ -1,5 +1,6 @@
 import { setCurrentSpan } from "../tracing/context.mjs";
 import { createAgentSpan } from "../tracing/index.mjs";
+import { getGlobalTraceProvider } from "../tracing/provider.mjs";
 /**
  * Normalizes tracing configuration into the format expected by model providers.
  * Returns `false` to disable tracing, `true` to include full payload data, or
@@ -14,6 +15,47 @@ export function getTracing(tracingDisabled, traceIncludeSensitiveData) {
     }
     return 'enabled_without_data';
 }
+function rebaseSpanChain(span, trace) {
+    const previousSpan = span.previousSpan
+        ? rebaseSpanChain(span.previousSpan, trace)
+        : undefined;
+    const parent = previousSpan ?? trace;
+    const rebasedSpan = getGlobalTraceProvider().createSpan({
+        spanId: span.spanId,
+        parentId: span.parentId ?? undefined,
+        startedAt: span.startedAt ?? undefined,
+        endedAt: span.endedAt ?? undefined,
+        data: span.spanData,
+        error: span.error ?? undefined,
+        tracingApiKey: span.tracingApiKey,
+    }, parent);
+    rebasedSpan.previousSpan = previousSpan;
+    return rebasedSpan;
+}
+export function applyTraceOverrides(trace, currentSpan, overrides) {
+    const traceIdOverride = overrides.traceId !== undefined && overrides.traceId !== trace.traceId;
+    const tracingApiKeyOverride = overrides.tracingApiKey !== undefined &&
+        overrides.tracingApiKey !== trace.tracingApiKey;
+    if (overrides.traceId !== undefined) {
+        trace.traceId = overrides.traceId;
+    }
+    if (overrides.workflowName !== undefined) {
+        trace.name = overrides.workflowName;
+    }
+    if (overrides.groupId !== undefined) {
+        trace.groupId = overrides.groupId ?? null;
+    }
+    if (overrides.traceMetadata !== undefined) {
+        trace.metadata = overrides.traceMetadata;
+    }
+    if (overrides.tracingApiKey !== undefined) {
+        trace.tracingApiKey = overrides.tracingApiKey;
+    }
+    if (currentSpan && (traceIdOverride || tracingApiKeyOverride)) {
+        return { trace, currentSpan: rebaseSpanChain(currentSpan, trace) };
+    }
+    return { trace, currentSpan };
+}
 /**
  * Ensures an agent span exists and updates tool metadata if already present.
  * Returns the span so callers can pass it through run state.

package/dist/runner/tracing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.mjs","sourceRoot":"","sources":["../../src/runner/tracing.ts"],"names":[],"mappings":"OAIO,EAAE,cAAc,EAAE;OAClB,EAAE,eAAe,EAAE;AAS1B;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,eAAwB,EACxB,yBAAkC;IAElC,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,yBAAyB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAuC;IAEvC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvD,MAAM,YAAY,GAAG,WAAW,CAAC;IACjC,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/B,WAAW,EAAE,KAAK,CAAC,gBAAgB;SACpC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACb,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"tracing.mjs","sourceRoot":"","sources":["../../src/runner/tracing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@openai/agents-core",
   "repository": "https://github.com/openai/openai-agents-js",
   "homepage": "https://openai.github.io/openai-agents-js/",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows.",
   "author": "OpenAI <support@openai.com>",
   "main": "dist/index.js",