raindrop-ai 0.1.5 → 0.1.6-otelv2

package/dist/{chunk-5TO4YOAA.mjs → chunk-IRFBHPGQ.mjs}

@@ -377,7 +377,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.1.5",
+  version: "0.1.6",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -1499,20 +1499,34 @@ var LiveInteraction = class {
     return this.context.eventId;
   }
   async finish(resultEvent) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     if (!this.traceId) {
       this.resolveLiveTraceId();
     }
+    const spanFlush = (async () => {
+      var _a2;
+      try {
+        await ((_a2 = this.analytics) == null ? void 0 : _a2._flushTracingSpans());
+      } catch (e) {
+      }
+    })();
+    if ((_b = (_a = this.analytics) == null ? void 0 : _a._shouldBlockFinishFlush()) != null ? _b : true) {
+      await spanFlush;
+    } else {
+      void spanFlush.catch(() => {
+      });
+    }
+    const eventId = resultEvent.eventId || this.context.eventId;
     try {
-      await ((_a = this.analytics) == null ? void 0 : _a.forceFlush());
+      await ((_c = this.analytics) == null ? void 0 : _c._drainInFlightPartials(eventId));
     } catch (e) {
     }
     if (this.traceId) {
       this.setProperty("trace_id", this.traceId);
     }
-    await ((_b = this.analytics) == null ? void 0 : _b._trackAiPartial({
+    await ((_d = this.analytics) == null ? void 0 : _d._trackAiPartial({
       ...resultEvent,
-      eventId: resultEvent.eventId || this.context.eventId,
+      eventId,
       isPending: false
     }));
   }
@@ -2192,6 +2206,10 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
         baseUrl: apiUrl,
         apiKey: writeKey,
         logLevel,
+        // Traceloop's init banner ("Traceloop exporting traces to <baseUrl>") is
+        // misleading inside our wrapper: in external-OTEL mode we create no
+        // exporter at all (tracingEnabled: false). Suppress it.
+        silenceInitializationMessage: true,
         tracingEnabled: false
         // DO NOT create NodeSDK - customer has their own
       });
@@ -2222,6 +2240,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
             apiKey: writeKey,
             ...otherOptions,
             logLevel,
+            silenceInitializationMessage: true,
             tracingEnabled: tracingEnabled !== false,
             disableBatch: disableBatching,
             processor: localDebuggerProcessor
@@ -2232,6 +2251,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
             baseUrl: apiUrl,
             apiKey: writeKey,
             logLevel,
+            silenceInitializationMessage: true,
             tracingEnabled: false
           });
           traceloopInitialized = true;
@@ -2247,6 +2267,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
           apiKey: writeKey,
           ...otherOptions,
           logLevel,
+          silenceInitializationMessage: true,
           tracingEnabled: tracingEnabled !== false,
           disableBatch: disableBatching,
           ...processor ? { processor } : {},

package/dist/index.d.mts

@@ -827,6 +827,26 @@ interface AnalyticsConfig {
      * @default false
      */
     bypassOtelForTools?: boolean;
+    /**
+     * Whether `interaction.finish()` should await the in-flight span/trace flush
+     * (i.e. `forceFlush()`, which drains buffered OTLP/tool spans — a `/v1/traces`
+     * POST with retries) before resolving. This await was added so a local
+     * Workshop daemon doesn't race OTLP ingest; in cloud mode it only adds
+     * request latency.
+     *
+     * Note this gates *only* the span flush. `finish()` always awaits the
+     * terminal partial-event POST that records the run, and always orders it
+     * after any earlier in-flight POST for the same eventId — to skip the
+     * partial POST too, simply don't `await interaction.finish(...)`.
+     *
+     * - `true` / `undefined` (default) — await the span/trace flush, preserving
+     *   the historical guaranteed-flush-before-return behavior.
+     * - `false` — don't await it; it drains in the background so the caller's
+     *   request isn't taxed by the round trip + retries. A local Workshop /
+     *   debugger still forces the await regardless (its read-after-write
+     *   guarantee depends on it).
+     */
+    awaitSpanFlush?: boolean;
     /**
      * Explicitly specify modules to instrument. Optional.
      *
@@ -875,9 +895,11 @@ declare class Raindrop {
     private context;
     private _tracing;
     private localDebuggerUrlOpt;
+    private awaitSpanFlushOpt;
     private partialEventBuffer;
     private partialEventTimeouts;
     private inFlightRequests;
+    private inFlightByEvent;
     private maxTextFieldChars;
     private projectId;
     /**

package/dist/index.d.ts

@@ -827,6 +827,26 @@ interface AnalyticsConfig {
      * @default false
      */
     bypassOtelForTools?: boolean;
+    /**
+     * Whether `interaction.finish()` should await the in-flight span/trace flush
+     * (i.e. `forceFlush()`, which drains buffered OTLP/tool spans — a `/v1/traces`
+     * POST with retries) before resolving. This await was added so a local
+     * Workshop daemon doesn't race OTLP ingest; in cloud mode it only adds
+     * request latency.
+     *
+     * Note this gates *only* the span flush. `finish()` always awaits the
+     * terminal partial-event POST that records the run, and always orders it
+     * after any earlier in-flight POST for the same eventId — to skip the
+     * partial POST too, simply don't `await interaction.finish(...)`.
+     *
+     * - `true` / `undefined` (default) — await the span/trace flush, preserving
+     *   the historical guaranteed-flush-before-return behavior.
+     * - `false` — don't await it; it drains in the background so the caller's
+     *   request isn't taxed by the round trip + retries. A local Workshop /
+     *   debugger still forces the await regardless (its read-after-write
+     *   guarantee depends on it).
+     */
+    awaitSpanFlush?: boolean;
     /**
      * Explicitly specify modules to instrument. Optional.
      *
@@ -875,9 +895,11 @@ declare class Raindrop {
     private context;
     private _tracing;
     private localDebuggerUrlOpt;
+    private awaitSpanFlushOpt;
     private partialEventBuffer;
     private partialEventTimeouts;
     private inFlightRequests;
+    private inFlightByEvent;
     private maxTextFieldChars;
     private projectId;
     /**

package/dist/index.js

@@ -10255,7 +10255,7 @@ var SignalEventSchema = external_exports.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.1.5",
+  version: "0.1.6",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -11457,20 +11457,34 @@ var LiveInteraction = class {
     return this.context.eventId;
   }
   async finish(resultEvent) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     if (!this.traceId) {
       this.resolveLiveTraceId();
     }
+    const spanFlush = (async () => {
+      var _a2;
+      try {
+        await ((_a2 = this.analytics) == null ? void 0 : _a2._flushTracingSpans());
+      } catch (e) {
+      }
+    })();
+    if ((_b = (_a = this.analytics) == null ? void 0 : _a._shouldBlockFinishFlush()) != null ? _b : true) {
+      await spanFlush;
+    } else {
+      void spanFlush.catch(() => {
+      });
+    }
+    const eventId = resultEvent.eventId || this.context.eventId;
     try {
-      await ((_a = this.analytics) == null ? void 0 : _a.forceFlush());
+      await ((_c = this.analytics) == null ? void 0 : _c._drainInFlightPartials(eventId));
     } catch (e) {
     }
     if (this.traceId) {
       this.setProperty("trace_id", this.traceId);
     }
-    await ((_b = this.analytics) == null ? void 0 : _b._trackAiPartial({
+    await ((_d = this.analytics) == null ? void 0 : _d._trackAiPartial({
       ...resultEvent,
-      eventId: resultEvent.eventId || this.context.eventId,
+      eventId,
       isPending: false
     }));
   }
@@ -12150,6 +12164,10 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
         baseUrl: apiUrl,
         apiKey: writeKey,
         logLevel,
+        // Traceloop's init banner ("Traceloop exporting traces to <baseUrl>") is
+        // misleading inside our wrapper: in external-OTEL mode we create no
+        // exporter at all (tracingEnabled: false). Suppress it.
+        silenceInitializationMessage: true,
         tracingEnabled: false
         // DO NOT create NodeSDK - customer has their own
       });
@@ -12180,6 +12198,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
             apiKey: writeKey,
             ...otherOptions,
             logLevel,
+            silenceInitializationMessage: true,
             tracingEnabled: tracingEnabled !== false,
             disableBatch: disableBatching,
             processor: localDebuggerProcessor
@@ -12190,6 +12209,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
             baseUrl: apiUrl,
             apiKey: writeKey,
             logLevel,
+            silenceInitializationMessage: true,
             tracingEnabled: false
           });
           traceloopInitialized = true;
@@ -12205,6 +12225,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
           apiKey: writeKey,
           ...otherOptions,
           logLevel,
+          silenceInitializationMessage: true,
           tracingEnabled: tracingEnabled !== false,
           disableBatch: disableBatching,
           ...processor ? { processor } : {},
@@ -12588,6 +12609,9 @@ var Raindrop = class {
     this.partialEventBuffer = /* @__PURE__ */ new Map();
     this.partialEventTimeouts = /* @__PURE__ */ new Map();
     this.inFlightRequests = /* @__PURE__ */ new Set();
+    // In-flight partial-event POSTs grouped by eventId, so finish() can order its
+    // terminal POST after only that event's earlier POSTs (not unrelated ones).
+    this.inFlightByEvent = /* @__PURE__ */ new Map();
     /**
      * Set once `close()` begins and never cleared. Sends issued after the
      * drain window (stragglers, or flush work the deadline abandoned
@@ -12600,6 +12624,7 @@ var Raindrop = class {
     this.maxTextFieldChars = resolveMaxTextFieldChars(config.maxTextFieldChars);
     this.writeKey = (_a = config.writeKey) != null ? _a : "";
     this.localDebuggerUrlOpt = config.localWorkshopUrl === false ? null : config.localWorkshopUrl;
+    this.awaitSpanFlushOpt = config.awaitSpanFlush;
     this.apiUrl = (_b = this.formatEndpoint(config.endpoint)) != null ? _b : `https://api.raindrop.ai/v1/`;
     this.bufferSize = (_c = config.bufferSize) != null ? _c : 50;
     this.bufferTimeout = (_d = config.bufferTimeout) != null ? _d : 1e3;
@@ -13240,6 +13265,12 @@ var Raindrop = class {
   async flushPartialEvent(eventId) {
     const flushPromise = this._flushPartialEventInternal(eventId);
     this.inFlightRequests.add(flushPromise);
+    let perEvent = this.inFlightByEvent.get(eventId);
+    if (!perEvent) {
+      perEvent = /* @__PURE__ */ new Set();
+      this.inFlightByEvent.set(eventId, perEvent);
+    }
+    perEvent.add(flushPromise);
     try {
       await flushPromise;
     } catch (error) {
@@ -13252,6 +13283,8 @@ var Raindrop = class {
       );
     } finally {
       this.inFlightRequests.delete(flushPromise);
+      perEvent.delete(flushPromise);
+      if (perEvent.size === 0) this.inFlightByEvent.delete(eventId);
     }
   }
   /**
@@ -13410,13 +13443,48 @@ var Raindrop = class {
    * Safe to call multiple times; never throws.
    */
   async forceFlush() {
+    await this._flushTracingSpans();
+    await this._drainInFlightPartials();
+  }
+  /**
+   * Best-effort drain of buffered OTel/tool spans (traceloop + direct shipper).
+   * This is the round-trip-heavy part of `forceFlush()` (e.g. the `/v1/traces`
+   * POST with retries); kept separate so `finish()` can background it.
+   * @internal
+   */
+  async _flushTracingSpans() {
     try {
       await this._tracing.forceFlush();
     } catch (e) {
     }
-    if (this.inFlightRequests.size > 0) {
-      await Promise.allSettled(Array.from(this.inFlightRequests));
+  }
+  /**
+   * Wait for already-issued partial-event POSTs to settle. Used to order the
+   * terminal partial-event POST after any earlier in-flight POST for the same
+   * eventId so they can't be ingested out of order. Pass `eventId` to wait only
+   * on that event's POSTs (what `finish()` needs); omit it to drain all.
+   * @internal
+   */
+  async _drainInFlightPartials(eventId) {
+    const pending = eventId !== void 0 ? this.inFlightByEvent.get(eventId) : this.inFlightRequests;
+    if (pending && pending.size > 0) {
+      await Promise.allSettled(Array.from(pending));
+    }
+  }
+  /**
+   * Whether `interaction.finish()` should await the in-flight span/trace flush
+   * before resolving. Blocks by default (preserving the historical behavior);
+   * callers opt out with `awaitSpanFlush: false`. A local Workshop/debugger
+   * always forces the await (its read-after-write guarantee depends on it),
+   * even when `awaitSpanFlush: false`. The terminal partial-event POST is
+   * always awaited by `finish()`, independent of this.
+   * @internal
+   */
+  _shouldBlockFinishFlush() {
+    if (resolveLocalDebuggerBaseUrl(this.localDebuggerUrlOpt) !== null) {
+      return true;
     }
+    return this.awaitSpanFlushOpt !== false;
   }
   async close() {
     this.hasShutdown = true;
@@ -13476,6 +13544,7 @@ var Raindrop = class {
     this.partialEventTimeouts.forEach(clearTimeout);
     this.partialEventTimeouts.clear();
     this.inFlightRequests.clear();
+    this.inFlightByEvent.clear();
     if (this.debugLogs) {
       console.log("[raindrop] Closing Raindrop Analytics");
     }

package/dist/index.mjs

@@ -16,7 +16,7 @@ import {
   setDefaultMaxTextFieldChars,
   stringifyBounded,
   tracing
-} from "./chunk-5TO4YOAA.mjs";
+} from "./chunk-IRFBHPGQ.mjs";
 import {
   __commonJS,
   __toESM
@@ -10138,6 +10138,9 @@ var Raindrop = class {
     this.partialEventBuffer = /* @__PURE__ */ new Map();
     this.partialEventTimeouts = /* @__PURE__ */ new Map();
     this.inFlightRequests = /* @__PURE__ */ new Set();
+    // In-flight partial-event POSTs grouped by eventId, so finish() can order its
+    // terminal POST after only that event's earlier POSTs (not unrelated ones).
+    this.inFlightByEvent = /* @__PURE__ */ new Map();
     /**
      * Set once `close()` begins and never cleared. Sends issued after the
      * drain window (stragglers, or flush work the deadline abandoned
@@ -10150,6 +10153,7 @@ var Raindrop = class {
     this.maxTextFieldChars = resolveMaxTextFieldChars(config.maxTextFieldChars);
     this.writeKey = (_a = config.writeKey) != null ? _a : "";
     this.localDebuggerUrlOpt = config.localWorkshopUrl === false ? null : config.localWorkshopUrl;
+    this.awaitSpanFlushOpt = config.awaitSpanFlush;
     this.apiUrl = (_b = this.formatEndpoint(config.endpoint)) != null ? _b : `https://api.raindrop.ai/v1/`;
     this.bufferSize = (_c = config.bufferSize) != null ? _c : 50;
     this.bufferTimeout = (_d = config.bufferTimeout) != null ? _d : 1e3;
@@ -10790,6 +10794,12 @@ var Raindrop = class {
   async flushPartialEvent(eventId) {
     const flushPromise = this._flushPartialEventInternal(eventId);
     this.inFlightRequests.add(flushPromise);
+    let perEvent = this.inFlightByEvent.get(eventId);
+    if (!perEvent) {
+      perEvent = /* @__PURE__ */ new Set();
+      this.inFlightByEvent.set(eventId, perEvent);
+    }
+    perEvent.add(flushPromise);
     try {
       await flushPromise;
     } catch (error) {
@@ -10802,6 +10812,8 @@ var Raindrop = class {
       );
     } finally {
       this.inFlightRequests.delete(flushPromise);
+      perEvent.delete(flushPromise);
+      if (perEvent.size === 0) this.inFlightByEvent.delete(eventId);
     }
   }
   /**
@@ -10960,13 +10972,48 @@ var Raindrop = class {
    * Safe to call multiple times; never throws.
    */
   async forceFlush() {
+    await this._flushTracingSpans();
+    await this._drainInFlightPartials();
+  }
+  /**
+   * Best-effort drain of buffered OTel/tool spans (traceloop + direct shipper).
+   * This is the round-trip-heavy part of `forceFlush()` (e.g. the `/v1/traces`
+   * POST with retries); kept separate so `finish()` can background it.
+   * @internal
+   */
+  async _flushTracingSpans() {
     try {
       await this._tracing.forceFlush();
     } catch (e) {
     }
-    if (this.inFlightRequests.size > 0) {
-      await Promise.allSettled(Array.from(this.inFlightRequests));
+  }
+  /**
+   * Wait for already-issued partial-event POSTs to settle. Used to order the
+   * terminal partial-event POST after any earlier in-flight POST for the same
+   * eventId so they can't be ingested out of order. Pass `eventId` to wait only
+   * on that event's POSTs (what `finish()` needs); omit it to drain all.
+   * @internal
+   */
+  async _drainInFlightPartials(eventId) {
+    const pending = eventId !== void 0 ? this.inFlightByEvent.get(eventId) : this.inFlightRequests;
+    if (pending && pending.size > 0) {
+      await Promise.allSettled(Array.from(pending));
+    }
+  }
+  /**
+   * Whether `interaction.finish()` should await the in-flight span/trace flush
+   * before resolving. Blocks by default (preserving the historical behavior);
+   * callers opt out with `awaitSpanFlush: false`. A local Workshop/debugger
+   * always forces the await (its read-after-write guarantee depends on it),
+   * even when `awaitSpanFlush: false`. The terminal partial-event POST is
+   * always awaited by `finish()`, independent of this.
+   * @internal
+   */
+  _shouldBlockFinishFlush() {
+    if (resolveLocalDebuggerBaseUrl(this.localDebuggerUrlOpt) !== null) {
+      return true;
     }
+    return this.awaitSpanFlushOpt !== false;
   }
   async close() {
     this.hasShutdown = true;
@@ -11026,6 +11073,7 @@ var Raindrop = class {
     this.partialEventTimeouts.forEach(clearTimeout);
     this.partialEventTimeouts.clear();
     this.inFlightRequests.clear();
+    this.inFlightByEvent.clear();
     if (this.debugLogs) {
       console.log("[raindrop] Closing Raindrop Analytics");
     }

package/dist/tracing/index.js

@@ -542,7 +542,7 @@ function base64ToHex(base64) {
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.1.5",
+  version: "0.1.6",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -1489,20 +1489,34 @@ var LiveInteraction = class {
     return this.context.eventId;
   }
   async finish(resultEvent) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     if (!this.traceId) {
       this.resolveLiveTraceId();
     }
+    const spanFlush = (async () => {
+      var _a2;
+      try {
+        await ((_a2 = this.analytics) == null ? void 0 : _a2._flushTracingSpans());
+      } catch (e) {
+      }
+    })();
+    if ((_b = (_a = this.analytics) == null ? void 0 : _a._shouldBlockFinishFlush()) != null ? _b : true) {
+      await spanFlush;
+    } else {
+      void spanFlush.catch(() => {
+      });
+    }
+    const eventId = resultEvent.eventId || this.context.eventId;
     try {
-      await ((_a = this.analytics) == null ? void 0 : _a.forceFlush());
+      await ((_c = this.analytics) == null ? void 0 : _c._drainInFlightPartials(eventId));
     } catch (e) {
     }
     if (this.traceId) {
       this.setProperty("trace_id", this.traceId);
     }
-    await ((_b = this.analytics) == null ? void 0 : _b._trackAiPartial({
+    await ((_d = this.analytics) == null ? void 0 : _d._trackAiPartial({
       ...resultEvent,
-      eventId: resultEvent.eventId || this.context.eventId,
+      eventId,
       isPending: false
     }));
   }
@@ -2182,6 +2196,10 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
         baseUrl: apiUrl,
         apiKey: writeKey,
         logLevel,
+        // Traceloop's init banner ("Traceloop exporting traces to <baseUrl>") is
+        // misleading inside our wrapper: in external-OTEL mode we create no
+        // exporter at all (tracingEnabled: false). Suppress it.
+        silenceInitializationMessage: true,
         tracingEnabled: false
         // DO NOT create NodeSDK - customer has their own
       });
@@ -2212,6 +2230,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
             apiKey: writeKey,
             ...otherOptions,
             logLevel,
+            silenceInitializationMessage: true,
             tracingEnabled: tracingEnabled !== false,
             disableBatch: disableBatching,
             processor: localDebuggerProcessor
@@ -2222,6 +2241,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
             baseUrl: apiUrl,
             apiKey: writeKey,
             logLevel,
+            silenceInitializationMessage: true,
             tracingEnabled: false
           });
           traceloopInitialized = true;
@@ -2237,6 +2257,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
           apiKey: writeKey,
           ...otherOptions,
           logLevel,
+          silenceInitializationMessage: true,
           tracingEnabled: tracingEnabled !== false,
           disableBatch: disableBatching,
           ...processor ? { processor } : {},

package/dist/tracing/index.mjs

@@ -1,6 +1,6 @@
 import {
   tracing
-} from "../chunk-5TO4YOAA.mjs";
+} from "../chunk-IRFBHPGQ.mjs";
 import "../chunk-UJCSKKID.mjs";
 
 // src/tracing/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raindrop-ai",
-  "version": "0.1.5",
+  "version": "0.1.6-otelv2",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -32,9 +32,9 @@
     "dist/**"
   ],
   "devDependencies": {
-    "ai": "^6.0.0",
     "@opentelemetry/resources": "^2.0.1",
     "@types/node": "^20.11.17",
+    "ai": "^6.0.0",
     "msw": "^2.12.8",
     "tsup": "^8.4.0",
     "tsx": "^4.20.3",
@@ -42,13 +42,12 @@
     "vite": "^7.3.2",
     "vitest": "^4.0.10",
     "@raindrop-ai/core": "0.0.4",
-    "@raindrop-ai/redact-pii": "0.1.2",
-    "@raindrop-ai/schemas": "0.0.1"
+    "@raindrop-ai/schemas": "0.0.1",
+    "@raindrop-ai/redact-pii": "0.1.2"
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.57.2",
-    "@traceloop/node-server-sdk": "0.19.0-otel-v1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.203.0",
     "weakref": "^0.2.1",
     "zod": "^3.23.8"
   },
@@ -91,6 +90,9 @@
     },
     "clean": true
   },
+  "optionalDependencies": {
+    "@traceloop/node-server-sdk": "0.22.2"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",