@fallom/trace 0.1.0 → 0.1.1

package/README.md

@@ -14,12 +14,14 @@ npm install @fallom/trace @traceloop/node-server-sdk
 ## Quick Start
 
 ```typescript
+// ⚠️ IMPORTANT: Import and initialize Fallom BEFORE importing OpenAI!
 import fallom from '@fallom/trace';
-import OpenAI from 'openai';
 
-// Initialize FIRST - before importing your LLM libraries
 fallom.init({ apiKey: 'your-api-key' });
 
+// NOW import OpenAI (after instrumentation is set up)
+const { default: OpenAI } = await import('openai');
+
 // Set default session context for tracing
 fallom.trace.setSession('my-agent', sessionId);
 
@@ -31,6 +33,8 @@ const response = await openai.chat.completions.create({
 });
 ```
 
+> ⚠️ **Import Order Matters!** Auto-instrumentation hooks into libraries when they're imported. You must call `fallom.init()` BEFORE importing `openai`, `@anthropic-ai/sdk`, etc. Use dynamic imports (`await import('openai')`) to ensure correct order.
+
 ## Model A/B Testing
 
 Run A/B tests on models with zero latency. Same session always gets same model (sticky assignment).
@@ -99,15 +103,18 @@ Auto-capture all LLM calls with OpenTelemetry instrumentation.
 ### Automatic Tracing
 
 ```typescript
+// Step 1: Import and init Fallom FIRST
 import fallom from '@fallom/trace';
-
-// Initialize before making LLM calls
 fallom.init();
 
-// Set session context
+// Step 2: Dynamic import OpenAI AFTER init
+const { default: OpenAI } = await import('openai');
+const openai = new OpenAI();
+
+// Step 3: Set session context
 fallom.trace.setSession('my-agent', sessionId);
 
-// All LLM calls automatically traced with:
+// Step 4: Make LLM calls - automatically traced with:
 // - Model, tokens, latency
 // - Prompts and completions
 // - Your config_key and session_id
@@ -117,6 +124,11 @@ const response = await openai.chat.completions.create({
 });
 ```
 
+> **Required dependency:** Install `@traceloop/node-server-sdk` for auto-instrumentation:
+> ```bash
+> npm install @traceloop/node-server-sdk
+> ```
+
 ### Async Context Propagation
 
 For proper session context across async boundaries, use `runWithSession`:
@@ -269,6 +281,8 @@ See the `../examples/` folder for complete examples:
 
 - Node.js >= 18.0.0
 
+> ⚠️ **Bun Compatibility:** Auto-tracing uses OpenTelemetry instrumentation which relies on Node.js module hooks. **Bun has limited support** for this. For full tracing functionality, use Node.js. A/B testing (`models.get()`) works fine in Bun.
+
 ## License
 
 MIT

package/dist/index.js

@@ -727,12 +727,15 @@ function init(options = {}) {
 }
 function autoInstrument() {
   try {
-    const { Traceloop } = require("@traceloop/node-server-sdk");
+    const traceloopModule = require("@traceloop/node-server-sdk");
+    const Traceloop = traceloopModule.Traceloop || traceloopModule.default?.Traceloop || traceloopModule;
+    if (!Traceloop?.initialize) {
+      return;
+    }
     Traceloop.initialize({
-      baseUrl: `${baseUrl}/v1/traces`,
+      baseUrl,
       apiKey,
-      disableBatch: false,
-      // Respect capture content setting
+      disableBatch: true,
       traceContent: captureContent
     });
   } catch {

package/dist/index.mjs

@@ -710,12 +710,15 @@ function init(options = {}) {
 }
 function autoInstrument() {
   try {
-    const { Traceloop } = __require("@traceloop/node-server-sdk");
+    const traceloopModule = __require("@traceloop/node-server-sdk");
+    const Traceloop = traceloopModule.Traceloop || traceloopModule.default?.Traceloop || traceloopModule;
+    if (!Traceloop?.initialize) {
+      return;
+    }
     Traceloop.initialize({
-      baseUrl: `${baseUrl}/v1/traces`,
+      baseUrl,
       apiKey,
-      disableBatch: false,
-      // Respect capture content setting
+      disableBatch: true,
       traceContent: captureContent
     });
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fallom/trace",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Model A/B testing and tracing for LLM applications. Zero latency, production-ready.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -44,7 +44,8 @@
     "@opentelemetry/sdk-node": "^0.46.0",
     "@opentelemetry/sdk-trace-node": "^1.19.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.46.0",
-    "@traceloop/node-server-sdk": "^0.5.0"
+    "@traceloop/node-server-sdk": "^0.5.0",
+    "tslib": "^2.6.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
@@ -56,4 +57,3 @@
     "node": ">=18.0.0"
   }
 }
-