@goharvest/simforge 0.2.0 → 0.4.5

package/dist/openai-tracing.d.ts

@@ -0,0 +1,91 @@
+/**
+ * OpenAI Agents SDK tracing processor for Simforge.
+ *
+ * This module provides a TracingProcessor implementation that integrates with
+ * the OpenAI Agents SDK to automatically capture and send traces to Simforge.
+ *
+ * See: https://openai.github.io/openai-agents-js/
+ */
+import type { Span, Trace } from "@openai/agents";
+/**
+ * TracingProcessor interface from OpenAI Agents SDK v0.3.7
+ */
+export interface TracingProcessor {
+    onTraceStart(trace: Trace): Promise<void>;
+    onTraceEnd(trace: Trace): Promise<void>;
+    onSpanStart(span: Span<any>): Promise<void>;
+    onSpanEnd(span: Span<any>): Promise<void>;
+    forceFlush(): Promise<void>;
+    shutdown(timeout?: number): Promise<void>;
+}
+/**
+ * Tracing processor for OpenAI Agents SDK integration.
+ *
+ * Implements the TracingProcessor interface from the OpenAI Agents SDK to
+ * automatically capture traces and spans and send them to Simforge for
+ * monitoring and analysis.
+ *
+ * Example usage:
+ * ```typescript
+ * import { SimforgeOpenAITracingProcessor } from '@goharvest/simforge/openai-tracing';
+ * import { addTraceProcessor } from '@openai/agents';
+ *
+ * const processor = new SimforgeOpenAITracingProcessor({
+ *   apiKey: 'your-api-key',
+ *   serviceUrl: 'https://simforge.goharvest.ai'
+ * });
+ *
+ * addTraceProcessor(processor);
+ * ```
+ */
+export declare class SimforgeOpenAITracingProcessor implements TracingProcessor {
+    private readonly apiKey;
+    private readonly serviceUrl;
+    private readonly timeout;
+    private readonly activeTraces;
+    /**
+     * Initialize the tracing processor.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config: {
+        apiKey: string;
+        serviceUrl?: string;
+        timeout?: number;
+    });
+    /**
+     * Called when a trace is started.
+     */
+    onTraceStart(trace: Trace): Promise<void>;
+    /**
+     * Called when a trace is ended.
+     */
+    onTraceEnd(trace: Trace): Promise<void>;
+    /**
+     * Called when a span is started.
+     */
+    onSpanStart(_span: Span<any>): Promise<void>;
+    /**
+     * Called when a span is ended.
+     *
+     * For "response" spans (LLM calls), we send the trace data to Simforge.
+     */
+    onSpanEnd(span: Span<any>): Promise<void>;
+    /**
+     * Called when a trace is being flushed.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Called when the trace processor is shutting down.
+     */
+    shutdown(_timeout?: number): Promise<void>;
+    /**
+     * Send a trace for a single LLM call (response span).
+     */
+    private sendTraceForLLMCall;
+    /**
+     * Send trace data to Simforge API.
+     */
+    private sendTrace;
+}
+//# sourceMappingURL=openai-tracing.d.ts.map

package/dist/openai-tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-tracing.d.ts","sourceRoot":"","sources":["../src/openai-tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3C,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,8BAA+B,YAAW,gBAAgB;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAE7D;;;;OAIG;gBACS,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB;IAMD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IAEG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;;;OAIG;IAEG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;YACW,mBAAmB;IAmDjC;;OAEG;YACW,SAAS;CA8CxB"}

package/dist/openai-tracing.js

@@ -0,0 +1,179 @@
+/**
+ * OpenAI Agents SDK tracing processor for Simforge.
+ *
+ * This module provides a TracingProcessor implementation that integrates with
+ * the OpenAI Agents SDK to automatically capture and send traces to Simforge.
+ *
+ * See: https://openai.github.io/openai-agents-js/
+ */
+/**
+ * Tracing processor for OpenAI Agents SDK integration.
+ *
+ * Implements the TracingProcessor interface from the OpenAI Agents SDK to
+ * automatically capture traces and spans and send them to Simforge for
+ * monitoring and analysis.
+ *
+ * Example usage:
+ * ```typescript
+ * import { SimforgeOpenAITracingProcessor } from '@goharvest/simforge/openai-tracing';
+ * import { addTraceProcessor } from '@openai/agents';
+ *
+ * const processor = new SimforgeOpenAITracingProcessor({
+ *   apiKey: 'your-api-key',
+ *   serviceUrl: 'https://simforge.goharvest.ai'
+ * });
+ *
+ * addTraceProcessor(processor);
+ * ```
+ */
+export class SimforgeOpenAITracingProcessor {
+    /**
+     * Initialize the tracing processor.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        this.activeTraces = new Map();
+        this.apiKey = config.apiKey;
+        this.serviceUrl = config.serviceUrl ?? "https://simforge.goharvest.ai";
+        this.timeout = config.timeout ?? 10000;
+    }
+    /**
+     * Called when a trace is started.
+     */
+    async onTraceStart(trace) {
+        this.activeTraces.set(trace.traceId, trace);
+    }
+    /**
+     * Called when a trace is ended.
+     */
+    async onTraceEnd(trace) {
+        this.activeTraces.delete(trace.traceId);
+    }
+    /**
+     * Called when a span is started.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    async onSpanStart(_span) {
+        // No action needed on span start
+    }
+    /**
+     * Called when a span is ended.
+     *
+     * For "response" spans (LLM calls), we send the trace data to Simforge.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    async onSpanEnd(span) {
+        try {
+            // Only process "response" spans (LLM calls)
+            if (span.spanData?.type !== "response") {
+                return;
+            }
+            // Get the parent trace for context
+            const parentTrace = this.activeTraces.get(span.traceId);
+            if (!parentTrace) {
+                console.warn(`[SimforgeOpenAITracingProcessor] No parent trace found for span ${span.spanId}`);
+                return;
+            }
+            // Send the trace for this LLM call
+            await this.sendTraceForLLMCall(span, parentTrace);
+        }
+        catch (error) {
+            console.error("[SimforgeOpenAITracingProcessor] Error processing span end:", error);
+        }
+    }
+    /**
+     * Called when a trace is being flushed.
+     */
+    async forceFlush() {
+        // No buffering, so nothing to flush
+    }
+    /**
+     * Called when the trace processor is shutting down.
+     */
+    async shutdown(_timeout) {
+        this.activeTraces.clear();
+    }
+    /**
+     * Send a trace for a single LLM call (response span).
+     */
+    async sendTraceForLLMCall(
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    span, parentTrace) {
+        try {
+            // Serialize the trace and span data
+            const rawTrace = {
+                id: parentTrace.traceId,
+                workflow_name: parentTrace.name,
+                group_id: parentTrace.groupId,
+                metadata: parentTrace.metadata,
+            };
+            const rawSpan = {
+                id: span.spanId,
+                trace_id: span.traceId,
+                parent_id: span.parentId,
+                started_at: typeof span.startedAt === "string"
+                    ? span.startedAt
+                    : span.startedAt
+                        ? span.startedAt.toISOString()
+                        : undefined,
+                ended_at: typeof span.endedAt === "string"
+                    ? span.endedAt
+                    : span.endedAt
+                        ? span.endedAt.toISOString()
+                        : undefined,
+                span_data: span.spanData,
+                error: span.error,
+            };
+            // Send raw trace and span data - let server extract everything
+            const traceData = {
+                type: "openai",
+                source: "typescript-sdk-openai-tracing",
+                rawTrace,
+                rawSpan,
+            };
+            await this.sendTrace(traceData);
+        }
+        catch (error) {
+            console.error("[SimforgeOpenAITracingProcessor] Error sending trace for LLM call:", error);
+        }
+    }
+    /**
+     * Send trace data to Simforge API.
+     */
+    async sendTrace(traceData) {
+        const url = `${this.serviceUrl}/api/sdk/traces/external`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(traceData),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to send trace: HTTP ${response.status}: ${errorText.slice(0, 500)}`);
+            }
+            const result = await response.json();
+            console.debug(`[SimforgeOpenAITracingProcessor] Successfully sent trace to Simforge:`, result);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new Error(`Request timed out after ${this.timeout}ms`);
+                }
+                throw error;
+            }
+            throw new Error("Unknown error occurred while sending trace");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=openai-tracing.js.map

package/dist/openai-tracing.js.map

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

package/dist/tracing.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Tracing utilities for external trace submission to Simforge.
+ *
+ * This module provides utilities for sending external traces (e.g., from OpenAI API calls)
+ * to Simforge for monitoring and analysis.
+ */
+import type { Span, Trace } from "@openai/agents";
+export interface TraceResponse {
+    traceId: string;
+    status: "success";
+}
+/**
+ * TracingProcessor interface from OpenAI Agents SDK v0.3.7
+ */
+export interface TracingProcessor {
+    onTraceStart(trace: Trace): Promise<void>;
+    onTraceEnd(trace: Trace): Promise<void>;
+    onSpanStart(span: Span<any>): Promise<void>;
+    onSpanEnd(span: Span<any>): Promise<void>;
+    forceFlush(): Promise<void>;
+    shutdown(timeout?: number): Promise<void>;
+}
+/**
+ * Tracing processor for OpenAI Agents SDK integration.
+ *
+ * Implements the TracingProcessor interface from the OpenAI Agents SDK to
+ * automatically capture traces and spans and send them to Simforge for
+ * monitoring and analysis.
+ *
+ * Example usage:
+ * ```typescript
+ * import { Simforge } from '@goharvest/simforge';
+ * import { addTraceProcessor } from '@openai/agents';
+ *
+ * const client = new Simforge({ apiKey: 'your-api-key' });
+ * const processor = client.getOpenAiTracingProcessor();
+ * addTraceProcessor(processor);
+ * ```
+ */
+export declare class SimforgeOpenAITracingProcessor implements TracingProcessor {
+    private readonly apiKey;
+    private readonly serviceUrl;
+    private readonly timeout;
+    private readonly activeTraces;
+    /**
+     * Initialize the tracing processor.
+     *
+     * @param config - Configuration options
+     * @throws {Error} If @openai/agents is not installed
+     */
+    constructor(config: {
+        apiKey: string;
+        serviceUrl?: string;
+        timeout?: number;
+    });
+    /**
+     * Called when a trace is started.
+     */
+    onTraceStart(trace: Trace): Promise<void>;
+    /**
+     * Called when a trace is ended.
+     */
+    onTraceEnd(trace: Trace): Promise<void>;
+    /**
+     * Called when a span is started.
+     */
+    onSpanStart(span: Span<any>): Promise<void>;
+    /**
+     * Called when a span is ended.
+     *
+     * Send all spans to Simforge for complete trace capture.
+     */
+    onSpanEnd(span: Span<any>): Promise<void>;
+    /**
+     * Called when a trace is being flushed.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Called when the trace processor is shutting down.
+     */
+    shutdown(_timeout?: number): Promise<void>;
+    /**
+     * Send raw trace to Simforge API.
+     */
+    private sendRawTrace;
+    /**
+     * Export span to JSON object, collecting any errors.
+     */
+    private exportSpan;
+    /**
+     * Extract and add input/response to serialized span, updating errors list.
+     */
+    private extractSpanInputResponse;
+    /**
+     * Build span payload and handle JSON serialization, returning request body.
+     */
+    private buildSpanPayload;
+    private sendRawSpan;
+}
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAGjD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3C,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,8BAA+B,YAAW,gBAAgB;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAE7D;;;;;OAKG;gBACS,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB;IAaD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C;;OAEG;IAEG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD;;;;OAIG;IAEG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;YACW,YAAY;IAiD1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAiClB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2BhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAwCV,WAAW;CAkD1B"}

package/dist/tracing.js

@@ -0,0 +1,300 @@
+/**
+ * Tracing utilities for external trace submission to Simforge.
+ *
+ * This module provides utilities for sending external traces (e.g., from OpenAI API calls)
+ * to Simforge for monitoring and analysis.
+ */
+// Try to import OpenAI Agents SDK types - will fail at runtime if not installed
+let OPENAI_AGENTS_AVAILABLE = false;
+try {
+    // This will throw if @openai/agents is not installed
+    await import("@openai/agents");
+    OPENAI_AGENTS_AVAILABLE = true;
+}
+catch {
+    // @openai/agents not installed
+}
+import { __version__, DEFAULT_SERVICE_URL } from "./constants.js";
+/**
+ * Tracing processor for OpenAI Agents SDK integration.
+ *
+ * Implements the TracingProcessor interface from the OpenAI Agents SDK to
+ * automatically capture traces and spans and send them to Simforge for
+ * monitoring and analysis.
+ *
+ * Example usage:
+ * ```typescript
+ * import { Simforge } from '@goharvest/simforge';
+ * import { addTraceProcessor } from '@openai/agents';
+ *
+ * const client = new Simforge({ apiKey: 'your-api-key' });
+ * const processor = client.getOpenAiTracingProcessor();
+ * addTraceProcessor(processor);
+ * ```
+ */
+export class SimforgeOpenAITracingProcessor {
+    /**
+     * Initialize the tracing processor.
+     *
+     * @param config - Configuration options
+     * @throws {Error} If @openai/agents is not installed
+     */
+    constructor(config) {
+        this.activeTraces = new Map();
+        if (!OPENAI_AGENTS_AVAILABLE) {
+            throw new Error("@openai/agents is required for tracing functionality. " +
+                "Install it with: npm install @openai/agents");
+        }
+        this.apiKey = config.apiKey;
+        this.serviceUrl = config.serviceUrl ?? DEFAULT_SERVICE_URL;
+        this.timeout = config.timeout ?? 10000;
+    }
+    /**
+     * Called when a trace is started.
+     */
+    async onTraceStart(trace) {
+        this.activeTraces.set(trace.traceId, trace);
+        // Send the raw trace to Simforge immediately
+        try {
+            await this.sendRawTrace(trace);
+        }
+        catch (error) {
+            console.error("[SimforgeOpenAITracingProcessor] Error sending raw trace:", error);
+        }
+    }
+    /**
+     * Called when a trace is ended.
+     */
+    async onTraceEnd(trace) {
+        try {
+            // Send the raw trace again to capture any updates
+            await this.sendRawTrace(trace);
+        }
+        catch (error) {
+            console.error("[SimforgeOpenAITracingProcessor] Error sending raw trace on end:", error);
+        }
+        this.activeTraces.delete(trace.traceId);
+    }
+    /**
+     * Called when a span is started.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    async onSpanStart(span) {
+        try {
+            // Send the raw span to Simforge immediately
+            await this.sendRawSpan(span);
+        }
+        catch (error) {
+            console.error("[SimforgeOpenAITracingProcessor] Error sending raw span on start:", error);
+        }
+    }
+    /**
+     * Called when a span is ended.
+     *
+     * Send all spans to Simforge for complete trace capture.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    async onSpanEnd(span) {
+        try {
+            // Send the raw span to Simforge again to capture updates
+            await this.sendRawSpan(span);
+        }
+        catch (error) {
+            console.error("[SimforgeOpenAITracingProcessor] Error processing span end:", error);
+        }
+    }
+    /**
+     * Called when a trace is being flushed.
+     */
+    async forceFlush() {
+        // No buffering, so nothing to flush
+    }
+    /**
+     * Called when the trace processor is shutting down.
+     */
+    async shutdown(_timeout) {
+        this.activeTraces.clear();
+    }
+    /**
+     * Send raw trace to Simforge API.
+     */
+    async sendRawTrace(trace) {
+        const url = `${this.serviceUrl}/api/sdk/externalTraces`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const traceData = {
+                type: "openai",
+                source: "typescript-sdk-openai-tracing",
+                rawTrace: trace.toJSON(),
+                sdkVersion: __version__,
+            };
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(traceData),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to send raw trace: HTTP ${response.status}: ${errorText.slice(0, 500)}`);
+            }
+            const result = await response.json();
+            console.debug(`[SimforgeOpenAITracingProcessor] Successfully sent raw trace to Simforge:`, result);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new Error(`Request timed out after ${this.timeout}ms`);
+                }
+                throw error;
+            }
+            throw new Error("Unknown error occurred while sending raw trace");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Export span to JSON object, collecting any errors.
+     */
+    exportSpan(
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    span) {
+        const errors = [];
+        let serializedSpan;
+        try {
+            const jsonResult = span.toJSON();
+            if (typeof jsonResult !== "object" || jsonResult === null) {
+                errors.push({
+                    step: "span.toJSON()",
+                    error: `Returned unexpected type: ${typeof jsonResult}`,
+                });
+                serializedSpan = {};
+            }
+            else {
+                serializedSpan = jsonResult;
+            }
+        }
+        catch (error) {
+            errors.push({
+                step: "span.toJSON()",
+                error: error instanceof Error ? error.message : String(error),
+            });
+            serializedSpan = {};
+        }
+        if (!serializedSpan.span_data) {
+            serializedSpan.span_data = {};
+        }
+        return [serializedSpan, errors];
+    }
+    /**
+     * Extract and add input/response to serialized span, updating errors list.
+     */
+    extractSpanInputResponse(
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    span, serializedSpan, errors) {
+        const spanData = serializedSpan.span_data;
+        try {
+            spanData.input = span.spanData?._input || [];
+        }
+        catch (error) {
+            errors.push({
+                step: "access_input",
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        try {
+            spanData.response = span.spanData?._response || null;
+        }
+        catch (error) {
+            errors.push({
+                step: "access_response",
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Build span payload and handle JSON serialization, returning request body.
+     */
+    buildSpanPayload(
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    span, serializedSpan, errors) {
+        let spanPayload = {
+            type: "openai",
+            source: "typescript-sdk-openai-tracing",
+            sourceTraceId: span.traceId || "unknown",
+            rawSpan: serializedSpan,
+            sdkVersion: __version__,
+        };
+        if (errors.length > 0) {
+            spanPayload.errors = errors;
+        }
+        try {
+            return JSON.stringify(spanPayload);
+        }
+        catch (error) {
+            errors.push({
+                step: "json_serialize",
+                error: error instanceof Error ? error.message : String(error),
+            });
+            // Try to send what we can with error info
+            spanPayload = {
+                type: "openai",
+                source: "typescript-sdk-openai-tracing",
+                sourceTraceId: span.traceId || "unknown",
+                rawSpan: {
+                    id: span.spanId || "unknown",
+                    trace_id: span.traceId || "unknown",
+                },
+                errors: errors,
+            };
+            return JSON.stringify(spanPayload);
+        }
+    }
+    async sendRawSpan(
+    // biome-ignore lint/suspicious/noExplicitAny: OpenAI Agents SDK uses any for span data
+    span) {
+        const errors = [];
+        const [serializedSpan, exportErrors] = this.exportSpan(span);
+        errors.push(...exportErrors);
+        this.extractSpanInputResponse(span, serializedSpan, errors);
+        const requestBody = this.buildSpanPayload(span, serializedSpan, errors);
+        const url = `${this.serviceUrl}/api/sdk/externalSpans`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: requestBody,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to send raw span: HTTP ${response.status}: ${errorText.slice(0, 500)}`);
+            }
+            const result = await response.json();
+            console.debug(`[SimforgeOpenAITracingProcessor] Successfully sent raw span to Simforge:`, result);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new Error(`Request timed out after ${this.timeout}ms`);
+                }
+                throw error;
+            }
+            throw new Error("Unknown error occurred while sending raw span");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=tracing.js.map