raindrop-ai 0.2.1 → 0.2.2-otelv2

package/dist/index.d.mts

@@ -774,6 +774,14 @@ type Tracer = {
     emitLiveEvent(event: LocalDebuggerLiveEventInput): void;
 };
 
+declare global {
+    var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {
+        getStore(): T | undefined;
+        run<R>(store: T, callback: () => R): R;
+        enterWith?(store: T): void;
+    }) | undefined;
+}
+
 interface AnalyticsConfig {
     wizardSession?: string;
     /**
@@ -955,6 +963,7 @@ declare class Raindrop {
     private inFlightByEvent;
     private maxTextFieldChars;
     private projectId;
+    private authHint;
     /**
      * Epoch ms deadline while `close()` is draining; undefined otherwise.
      * Checked before every POST issued during the final flush so a dead or
@@ -975,6 +984,14 @@ declare class Raindrop {
     /**
      * Begins a new interaction.
      *
+     * The interaction's routing binding lives until `finish()` (which unbinds it
+     * by identity, so it is removed even if `finish()` runs inside a nested
+     * `withSpan`/`withTool`/`asCurrent` scope or a detached task). One exception:
+     * calling `begin()` INSIDE an `asCurrent(fn)` scope pushes the binding within
+     * that scope, so it dies when the scope exits (matching the Python SDK's
+     * token-reset semantics) — start such interactions outside `asCurrent`, or
+     * keep their work inside the same scope.
+     *
      * @param traceContext - The trace context for the interaction.
      * @returns The interaction object.
      */
@@ -991,6 +1008,20 @@ declare class Raindrop {
      * @returns The tracer object.
      */
     tracer(globalProperties?: Record<string, string>): Tracer;
+    /**
+     * Scope all spans created inside `fn` (and its awaited continuations) to this
+     * client's project/key, without an interaction. Use it around auto-
+     * instrumented calls (an LLM SDK call, a framework invocation) that aren't
+     * wrapped by `begin()`/`finish()` so their spans route to this client's
+     * project in a multi-client process. The binding lasts exactly the duration
+     * of `fn` — it is removed when `fn` returns or throws.
+     *
+     * @example
+     * ```ts
+     * const answer = await raindrop.asCurrent(() => llm.chat({ ... }));
+     * ```
+     */
+    asCurrent<T>(fn: () => T): T;
     createSpanProcessor(processorOptions?: SpanProcessorOptions): RaindropSpanProcessor;
     /**
      * Returns configured instrumentation instances based on instrumentModules.

package/dist/index.d.ts

@@ -774,6 +774,14 @@ type Tracer = {
     emitLiveEvent(event: LocalDebuggerLiveEventInput): void;
 };
 
+declare global {
+    var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {
+        getStore(): T | undefined;
+        run<R>(store: T, callback: () => R): R;
+        enterWith?(store: T): void;
+    }) | undefined;
+}
+
 interface AnalyticsConfig {
     wizardSession?: string;
     /**
@@ -955,6 +963,7 @@ declare class Raindrop {
     private inFlightByEvent;
     private maxTextFieldChars;
     private projectId;
+    private authHint;
     /**
      * Epoch ms deadline while `close()` is draining; undefined otherwise.
      * Checked before every POST issued during the final flush so a dead or
@@ -975,6 +984,14 @@ declare class Raindrop {
     /**
      * Begins a new interaction.
      *
+     * The interaction's routing binding lives until `finish()` (which unbinds it
+     * by identity, so it is removed even if `finish()` runs inside a nested
+     * `withSpan`/`withTool`/`asCurrent` scope or a detached task). One exception:
+     * calling `begin()` INSIDE an `asCurrent(fn)` scope pushes the binding within
+     * that scope, so it dies when the scope exits (matching the Python SDK's
+     * token-reset semantics) — start such interactions outside `asCurrent`, or
+     * keep their work inside the same scope.
+     *
      * @param traceContext - The trace context for the interaction.
      * @returns The interaction object.
      */
@@ -991,6 +1008,20 @@ declare class Raindrop {
      * @returns The tracer object.
      */
     tracer(globalProperties?: Record<string, string>): Tracer;
+    /**
+     * Scope all spans created inside `fn` (and its awaited continuations) to this
+     * client's project/key, without an interaction. Use it around auto-
+     * instrumented calls (an LLM SDK call, a framework invocation) that aren't
+     * wrapped by `begin()`/`finish()` so their spans route to this client's
+     * project in a multi-client process. The binding lasts exactly the duration
+     * of `fn` — it is removed when `fn` returns or throws.
+     *
+     * @example
+     * ```ts
+     * const answer = await raindrop.asCurrent(() => llm.chat({ ... }));
+     * ```
+     */
+    asCurrent<T>(fn: () => T): T;
     createSpanProcessor(processorOptions?: SpanProcessorOptions): RaindropSpanProcessor;
     /**
      * Returns configured instrumentation instances based on instrumentModules.