@posthog/ai 8.2.3 → 8.3.0

package/dist/openai-agents/index.mjs

@@ -74,6 +74,33 @@ const sharedTextEncoder = new TextEncoder();
 const sharedTextDecoder = new TextDecoder(STRING_FORMAT, {
   fatal: false
 });
+const utf8ByteLength = str => sharedTextEncoder.encode(str).byteLength;
+
+/**
+ * Safely converts content to a string, preserving structure for objects/arrays.
+ * - If content is already a string, returns it as-is
+ * - If content is an object or array, stringifies it with JSON.stringify to preserve structure
+ * - Otherwise, converts to string with String()
+ *
+ * This prevents the "[object Object]" bug when objects are naively converted to strings.
+ *
+ * @param content - The content to convert to a string
+ * @returns A string representation that preserves structure for complex types
+ */
+function toContentString(content) {
+  if (typeof content === 'string') {
+    return content;
+  }
+  if (content !== undefined && content !== null && typeof content === 'object') {
+    try {
+      return JSON.stringify(content);
+    } catch {
+      // Fallback for circular refs, BigInt, or objects with throwing toJSON
+      return String(content);
+    }
+  }
+  return String(content);
+}
 const withPrivacyMode = (client, privacyMode, input) => {
   return client.privacy_mode || privacyMode ? null : input;
 };
@@ -114,7 +141,7 @@ const truncate = input => {
   return `${truncatedStr}... [truncated]`;
 };
 
-var version = "8.2.3";
+var version = "8.3.0";
 
 // Warn when a wrapper's base_url points at the PostHog AI Gateway: the gateway
 // emits its own $ai_generation, so each call would be captured (and, for billable
@@ -181,38 +208,46 @@ function normalizeInputRoles(input) {
     return item;
   });
 }
+function safeContentString(value) {
+  try {
+    return toContentString(value);
+  } catch {
+    return Object.prototype.toString.call(value);
+  }
+}
 function ensureSerializable(obj) {
   if (obj === null || obj === undefined) {
     return obj;
   }
   try {
-    JSON.stringify(obj);
-    return obj;
+    const serializedValue = JSON.stringify(obj);
+    return serializedValue === undefined ? safeContentString(obj) : obj;
   } catch {
-    return String(obj);
+    return safeContentString(obj);
   }
 }
-function exceedsMaxOutputSize(value) {
+function stringifyForSizeCheck(value) {
   if (value === null || value === undefined) {
-    return false;
+    return null;
+  }
+  if (typeof value === 'string') {
+    return value;
   }
   try {
-    const serializedValue = typeof value === 'string' ? value : JSON.stringify(value);
-    return new TextEncoder().encode(serializedValue).length > MAX_OUTPUT_SIZE;
+    return JSON.stringify(value) ?? safeContentString(value);
   } catch {
-    return false;
+    return safeContentString(value);
   }
 }
+function exceedsMaxOutputSize(serializedValue) {
+  return serializedValue === null ? false : utf8ByteLength(serializedValue) > MAX_OUTPUT_SIZE;
+}
 function parseIsoTimestamp(isoStr) {
-  if (!isoStr) {
-    return null;
-  }
-  try {
-    const ts = new Date(isoStr).getTime();
-    return isNaN(ts) ? null : ts / 1000;
-  } catch {
+  if (typeof isoStr !== 'string' || isoStr.trim() === '') {
     return null;
   }
+  const ts = new Date(isoStr).getTime();
+  return Number.isFinite(ts) ? ts / 1000 : null;
 }
 /**
  * A tracing processor that sends OpenAI Agents SDK traces to PostHog.
@@ -242,6 +277,7 @@ class PostHogTracingProcessor {
     this._privacyMode = options.privacyMode ?? false;
     this._groups = options.groups ?? {};
     this._properties = options.properties ?? {};
+    this._onError = options.onError;
   }
   _getDistinctId(trace) {
     if (typeof this._distinctId === 'function') {
@@ -262,7 +298,8 @@ class PostHogTracingProcessor {
   }
   _prepareCapturedValue(value) {
     const serializableValue = ensureSerializable(value);
-    const boundedValue = exceedsMaxOutputSize(serializableValue) ? truncate(serializableValue) : serializableValue;
+    const serializedValue = stringifyForSizeCheck(serializableValue);
+    const boundedValue = exceedsMaxOutputSize(serializedValue) ? truncate(serializedValue) : serializableValue;
     return this._withPrivacyMode(boundedValue);
   }
   _evictStaleEntries() {
@@ -281,6 +318,12 @@ class PostHogTracingProcessor {
       }
     }
   }
+  _handleError(error, context) {
+    try {
+      this._onError?.(error, context);
+    } catch (handlerError) {
+    }
+  }
   _captureEvent(event, properties, distinctId) {
     try {
       if (!this._client?.capture) {
@@ -297,8 +340,8 @@ class PostHogTracingProcessor {
         groups: Object.keys(this._groups).length > 0 ? this._groups : undefined
       };
       this._client.capture(eventMessage);
-    } catch {
-      // Silently ignore capture errors
+    } catch (error) {
+      this._handleError(error, 'capture');
     }
   }
   _baseProperties(traceId, spanId, parentId, latency, groupId, errorProperties) {
@@ -359,8 +402,8 @@ class PostHogTracingProcessor {
         distinctId,
         startTime: Date.now() / 1000
       });
-    } catch {
-      // Silently ignore errors
+    } catch (error) {
+      this._handleError(error, 'onTraceStart');
     }
   }
   async onTraceEnd(trace) {
@@ -395,16 +438,16 @@ class PostHogTracingProcessor {
         properties.$process_person_profile = false;
       }
       this._captureEvent('$ai_trace', properties, distinctId ?? traceId);
-    } catch {
-      // Silently ignore errors
+    } catch (error) {
+      this._handleError(error, 'onTraceEnd');
     }
   }
   async onSpanStart(span) {
     try {
       this._evictStaleEntries();
       this._spanStartTimes.set(span.spanId, Date.now() / 1000);
-    } catch {
-      // Silently ignore errors
+    } catch (error) {
+      this._handleError(error, 'onSpanStart');
     }
   }
   async onSpanEnd(span) {
@@ -477,8 +520,8 @@ class PostHogTracingProcessor {
           this._handleGenericSpan(spanData, traceId, spanId, parentId, latency, distinctId, groupId, errorProperties);
           break;
       }
-    } catch {
-      // Silently ignore errors
+    } catch (error) {
+      this._handleError(error, 'onSpanEnd');
     }
   }
   async shutdown() {
@@ -488,8 +531,8 @@ class PostHogTracingProcessor {
       if (typeof this._client?.flush === 'function') {
         await this._client.flush();
       }
-    } catch {
-      // Silently ignore errors
+    } catch (error) {
+      this._handleError(error, 'shutdown');
     }
   }
   async forceFlush() {
@@ -497,8 +540,8 @@ class PostHogTracingProcessor {
       if (typeof this._client?.flush === 'function') {
         await this._client.flush();
       }
-    } catch {
-      // Silently ignore errors
+    } catch (error) {
+      this._handleError(error, 'forceFlush');
     }
   }