@raindrop-ai/ai-sdk 0.0.25 → 0.0.27

package/dist/{index-sxjvhkYW.d.mts → index-TERu6zvv.d.mts}

@@ -130,6 +130,11 @@ type TraceShipperOptions = {
     sdkName?: string;
     serviceName?: string;
     serviceVersion?: string;
+    /**
+     * Explicit Workshop / local debugger URL. Wins over env vars + auto-detect.
+     * Pass `null` to opt out of all mirroring (including auto-detect).
+     */
+    localDebuggerUrl?: string | null;
 };
 declare class TraceShipper$1 {
     private baseUrl;
@@ -147,7 +152,7 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
-    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
@@ -224,22 +229,16 @@ declare class TraceShipper extends TraceShipper$1 {
     constructor(opts: ConstructorParameters<typeof TraceShipper$1>[0]);
 }
 
-/**
- * Raindrop TelemetryIntegration for AI SDK v7+
- *
- * Implements the AI SDK's TelemetryIntegration interface to capture traces and
- * events natively, replacing the Proxy-based wrapping used for v4-v6.
- *
- * Modeled after the upstream OpenTelemetryIntegration but uses Raindrop's
- * TraceShipper (OTLP/HTTP) + EventShipper instead of the OTel Tracer API.
- */
-
 type Listener<T> = (event: T) => PromiseLike<void> | void;
 interface TelemetryIntegration {
     onStart?: Listener<any>;
     onStepStart?: Listener<any>;
+    onToolExecutionStart?: Listener<any>;
+    onToolExecutionEnd?: Listener<any>;
     onToolCallStart?: Listener<any>;
     onToolCallFinish?: Listener<any>;
+    onLanguageModelCallStart?: Listener<any>;
+    onLanguageModelCallEnd?: Listener<any>;
     onChunk?: Listener<any>;
     onStepFinish?: Listener<any>;
     onEmbedStart?: Listener<any>;
@@ -287,8 +286,14 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private extractInputText;
     onStart: (event: any) => void;
     onStepStart: (event: any) => void;
+    private toolExecutionStart;
+    private toolExecutionEnd;
+    onToolExecutionStart: (event: any) => void;
+    onToolExecutionEnd: (event: any) => void;
     onToolCallStart: (event: any) => void;
     onToolCallFinish: (event: any) => void;
+    onLanguageModelCallStart: (_event: any) => void;
+    onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
@@ -309,6 +314,65 @@ type IdentifyInput = {
     traits?: Record<string, unknown>;
 };
 
+type RaindropCallMetadata = {
+    userId?: string;
+    eventId?: string;
+    /** True when the eventId was auto-generated by `eventMetadata()` rather than user-provided. */
+    eventIdGenerated?: boolean;
+    convoId?: string;
+    eventName?: string;
+    properties?: Record<string, unknown>;
+    /**
+     * Raw `metadata` record, preserved so the integration can write the
+     * full set of `raindrop.*` keys onto root spans (the trace shipper
+     * relies on this to surface metadata in the dashboard span attributes).
+     */
+    rawMetadata?: Record<string, unknown>;
+};
+declare global {
+    var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {
+        getStore(): T | undefined;
+        run<R>(store: T, callback: () => R): R;
+        enterWith?(store: T): void;
+    }) | undefined;
+}
+/** Test helper — allow tests to drop a stale fallback storage between runs. */
+declare function _resetRaindropCallMetadataStorage(): void;
+/**
+ * Returns the active per-call Raindrop metadata, or `undefined` if no
+ * call is currently in scope. Safe to call from any telemetry callback.
+ */
+declare function getCurrentRaindropCallMetadata(): RaindropCallMetadata | undefined;
+/**
+ * Runs `fn` with `metadata` bound as the active per-call Raindrop metadata.
+ * Visible to nested async work via `AsyncLocalStorage` when available.
+ */
+declare function runWithRaindropCallMetadata<R>(metadata: RaindropCallMetadata, fn: () => R): R;
+/**
+ * Inspect the first argument to an AI SDK function call (the call
+ * options object) and pull out any Raindrop metadata routed via one of:
+ *
+ *   1. top-level `metadata` — convention inherited from the v4-v6 Proxy
+ *      path (`extractRaindropCallOptions` in `wrap/wrapAISDK.ts`). Some
+ *      callers route `eventMetadata()` here to bypass framework-specific
+ *      `experimental_telemetry` typings;
+ *   2. `telemetry.metadata` — the v7 beta.111+ stable name (anticipated;
+ *      the v7 dispatcher does not currently forward `metadata`, but the
+ *      shape is what users will pass once it lands);
+ *   3. `experimental_telemetry.metadata` — the documented and currently
+ *      working channel for v6 + every published v7 beta.
+ *
+ * Priority is `(1) > (2) > (3)` to stay consistent with the v4-v6 path's
+ * `extractRaindropCallOptions`. If you ever change this order, the
+ * self-diagnostics injection in `wrapAISDK.ts` (which mutates the v3
+ * source only) becomes a re-read hazard — see the comment by
+ * `mergedAlsMetadata` in that file.
+ *
+ * Returns `undefined` when there is no Raindrop metadata to propagate,
+ * so callers can skip the ALS push entirely.
+ */
+declare function readRaindropCallMetadataFromArgs(args: readonly unknown[]): RaindropCallMetadata | undefined;
+
 declare function _resetWarnedMissingUserId(): void;
 
 /**
@@ -445,6 +509,18 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: string;
+    /**
+     * Force-enable (or opt out of) Workshop / local-debugger mirroring.
+     *
+     *   - `string` — explicit Workshop URL (e.g. `"http://localhost:5899/v1/"`),
+     *     wins over env vars and runtime auto-detect.
+     *   - `false` (or `null`) — explicit opt-out, even on localhost / when
+     *     `NODE_ENV=development` / when `RAINDROP_WORKSHOP` is set.
+     *   - `undefined` (default) — fall through to `RAINDROP_LOCAL_DEBUGGER`,
+     *     `RAINDROP_WORKSHOP`, and runtime auto-detect (localhost-ish hostname
+     *     OR `NODE_ENV=development` enables the default `:5899` daemon).
+     */
+    localWorkshopUrl?: string | false | null;
     traces?: {
         enabled?: boolean;
         flushIntervalMs?: number;
@@ -688,4 +764,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, type EndSpanArgs as E, type IdentifyInput as I, type RaindropAISDKClient as R, type SelfDiagnosticsOptions as S, type TraceSpan as T, type WrapAISDKOptions as W, _resetWarnedMissingUserId as _, type AISDKChatRequestMessageLike as a, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, type EventBuilder as h, type EventMetadataOptions as i, type RaindropAISDKContext as j, type RaindropAISDKOptions as k, RaindropTelemetryIntegration as l, type RaindropTelemetryIntegrationOptions as m, type SelfDiagnosticsSignalDefinition as n, type SelfDiagnosticsSignalDefinitions as o, type StartSpanArgs as p, type WrappedAI as q, type WrappedAISDK as r, createRaindropAISDK as s, currentSpan as t, eventMetadata as u, eventMetadataFromChatRequest as v, getContextManager as w, withCurrent as x };
+export { type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, readRaindropCallMetadataFromArgs as D, type EndSpanArgs as E, runWithRaindropCallMetadata as F, withCurrent as G, type IdentifyInput as I, type RaindropAISDKClient as R, type SelfDiagnosticsOptions as S, type TraceSpan as T, type WrapAISDKOptions as W, _resetRaindropCallMetadataStorage as _, type AISDKChatRequestMessageLike as a, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, type EventBuilder as h, type EventMetadataOptions as i, type RaindropAISDKContext as j, type RaindropAISDKOptions as k, type RaindropCallMetadata as l, RaindropTelemetryIntegration as m, type RaindropTelemetryIntegrationOptions as n, type SelfDiagnosticsSignalDefinition as o, type SelfDiagnosticsSignalDefinitions as p, type StartSpanArgs as q, type WrappedAI as r, type WrappedAISDK as s, _resetWarnedMissingUserId as t, createRaindropAISDK as u, currentSpan as v, eventMetadata as w, eventMetadataFromChatRequest as x, getContextManager as y, getCurrentRaindropCallMetadata as z };

package/dist/{index-sxjvhkYW.d.ts → index-TERu6zvv.d.ts}

@@ -130,6 +130,11 @@ type TraceShipperOptions = {
     sdkName?: string;
     serviceName?: string;
     serviceVersion?: string;
+    /**
+     * Explicit Workshop / local debugger URL. Wins over env vars + auto-detect.
+     * Pass `null` to opt out of all mirroring (including auto-detect).
+     */
+    localDebuggerUrl?: string | null;
 };
 declare class TraceShipper$1 {
     private baseUrl;
@@ -147,7 +152,7 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
-    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
@@ -224,22 +229,16 @@ declare class TraceShipper extends TraceShipper$1 {
     constructor(opts: ConstructorParameters<typeof TraceShipper$1>[0]);
 }
 
-/**
- * Raindrop TelemetryIntegration for AI SDK v7+
- *
- * Implements the AI SDK's TelemetryIntegration interface to capture traces and
- * events natively, replacing the Proxy-based wrapping used for v4-v6.
- *
- * Modeled after the upstream OpenTelemetryIntegration but uses Raindrop's
- * TraceShipper (OTLP/HTTP) + EventShipper instead of the OTel Tracer API.
- */
-
 type Listener<T> = (event: T) => PromiseLike<void> | void;
 interface TelemetryIntegration {
     onStart?: Listener<any>;
     onStepStart?: Listener<any>;
+    onToolExecutionStart?: Listener<any>;
+    onToolExecutionEnd?: Listener<any>;
     onToolCallStart?: Listener<any>;
     onToolCallFinish?: Listener<any>;
+    onLanguageModelCallStart?: Listener<any>;
+    onLanguageModelCallEnd?: Listener<any>;
     onChunk?: Listener<any>;
     onStepFinish?: Listener<any>;
     onEmbedStart?: Listener<any>;
@@ -287,8 +286,14 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private extractInputText;
     onStart: (event: any) => void;
     onStepStart: (event: any) => void;
+    private toolExecutionStart;
+    private toolExecutionEnd;
+    onToolExecutionStart: (event: any) => void;
+    onToolExecutionEnd: (event: any) => void;
     onToolCallStart: (event: any) => void;
     onToolCallFinish: (event: any) => void;
+    onLanguageModelCallStart: (_event: any) => void;
+    onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
@@ -309,6 +314,65 @@ type IdentifyInput = {
     traits?: Record<string, unknown>;
 };
 
+type RaindropCallMetadata = {
+    userId?: string;
+    eventId?: string;
+    /** True when the eventId was auto-generated by `eventMetadata()` rather than user-provided. */
+    eventIdGenerated?: boolean;
+    convoId?: string;
+    eventName?: string;
+    properties?: Record<string, unknown>;
+    /**
+     * Raw `metadata` record, preserved so the integration can write the
+     * full set of `raindrop.*` keys onto root spans (the trace shipper
+     * relies on this to surface metadata in the dashboard span attributes).
+     */
+    rawMetadata?: Record<string, unknown>;
+};
+declare global {
+    var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {
+        getStore(): T | undefined;
+        run<R>(store: T, callback: () => R): R;
+        enterWith?(store: T): void;
+    }) | undefined;
+}
+/** Test helper — allow tests to drop a stale fallback storage between runs. */
+declare function _resetRaindropCallMetadataStorage(): void;
+/**
+ * Returns the active per-call Raindrop metadata, or `undefined` if no
+ * call is currently in scope. Safe to call from any telemetry callback.
+ */
+declare function getCurrentRaindropCallMetadata(): RaindropCallMetadata | undefined;
+/**
+ * Runs `fn` with `metadata` bound as the active per-call Raindrop metadata.
+ * Visible to nested async work via `AsyncLocalStorage` when available.
+ */
+declare function runWithRaindropCallMetadata<R>(metadata: RaindropCallMetadata, fn: () => R): R;
+/**
+ * Inspect the first argument to an AI SDK function call (the call
+ * options object) and pull out any Raindrop metadata routed via one of:
+ *
+ *   1. top-level `metadata` — convention inherited from the v4-v6 Proxy
+ *      path (`extractRaindropCallOptions` in `wrap/wrapAISDK.ts`). Some
+ *      callers route `eventMetadata()` here to bypass framework-specific
+ *      `experimental_telemetry` typings;
+ *   2. `telemetry.metadata` — the v7 beta.111+ stable name (anticipated;
+ *      the v7 dispatcher does not currently forward `metadata`, but the
+ *      shape is what users will pass once it lands);
+ *   3. `experimental_telemetry.metadata` — the documented and currently
+ *      working channel for v6 + every published v7 beta.
+ *
+ * Priority is `(1) > (2) > (3)` to stay consistent with the v4-v6 path's
+ * `extractRaindropCallOptions`. If you ever change this order, the
+ * self-diagnostics injection in `wrapAISDK.ts` (which mutates the v3
+ * source only) becomes a re-read hazard — see the comment by
+ * `mergedAlsMetadata` in that file.
+ *
+ * Returns `undefined` when there is no Raindrop metadata to propagate,
+ * so callers can skip the ALS push entirely.
+ */
+declare function readRaindropCallMetadataFromArgs(args: readonly unknown[]): RaindropCallMetadata | undefined;
+
 declare function _resetWarnedMissingUserId(): void;
 
 /**
@@ -445,6 +509,18 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: string;
+    /**
+     * Force-enable (or opt out of) Workshop / local-debugger mirroring.
+     *
+     *   - `string` — explicit Workshop URL (e.g. `"http://localhost:5899/v1/"`),
+     *     wins over env vars and runtime auto-detect.
+     *   - `false` (or `null`) — explicit opt-out, even on localhost / when
+     *     `NODE_ENV=development` / when `RAINDROP_WORKSHOP` is set.
+     *   - `undefined` (default) — fall through to `RAINDROP_LOCAL_DEBUGGER`,
+     *     `RAINDROP_WORKSHOP`, and runtime auto-detect (localhost-ish hostname
+     *     OR `NODE_ENV=development` enables the default `:5899` daemon).
+     */
+    localWorkshopUrl?: string | false | null;
     traces?: {
         enabled?: boolean;
         flushIntervalMs?: number;
@@ -688,4 +764,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, type EndSpanArgs as E, type IdentifyInput as I, type RaindropAISDKClient as R, type SelfDiagnosticsOptions as S, type TraceSpan as T, type WrapAISDKOptions as W, _resetWarnedMissingUserId as _, type AISDKChatRequestMessageLike as a, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, type EventBuilder as h, type EventMetadataOptions as i, type RaindropAISDKContext as j, type RaindropAISDKOptions as k, RaindropTelemetryIntegration as l, type RaindropTelemetryIntegrationOptions as m, type SelfDiagnosticsSignalDefinition as n, type SelfDiagnosticsSignalDefinitions as o, type StartSpanArgs as p, type WrappedAI as q, type WrappedAISDK as r, createRaindropAISDK as s, currentSpan as t, eventMetadata as u, eventMetadataFromChatRequest as v, getContextManager as w, withCurrent as x };
+export { type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, readRaindropCallMetadataFromArgs as D, type EndSpanArgs as E, runWithRaindropCallMetadata as F, withCurrent as G, type IdentifyInput as I, type RaindropAISDKClient as R, type SelfDiagnosticsOptions as S, type TraceSpan as T, type WrapAISDKOptions as W, _resetRaindropCallMetadataStorage as _, type AISDKChatRequestMessageLike as a, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, type EventBuilder as h, type EventMetadataOptions as i, type RaindropAISDKContext as j, type RaindropAISDKOptions as k, type RaindropCallMetadata as l, RaindropTelemetryIntegration as m, type RaindropTelemetryIntegrationOptions as n, type SelfDiagnosticsSignalDefinition as o, type SelfDiagnosticsSignalDefinitions as p, type StartSpanArgs as q, type WrappedAI as r, type WrappedAISDK as s, _resetWarnedMissingUserId as t, createRaindropAISDK as u, currentSpan as v, eventMetadata as w, eventMetadataFromChatRequest as x, getContextManager as y, getCurrentRaindropCallMetadata as z };

package/dist/index.browser.d.mts

@@ -130,6 +130,11 @@ type TraceShipperOptions = {
     sdkName?: string;
     serviceName?: string;
     serviceVersion?: string;
+    /**
+     * Explicit Workshop / local debugger URL. Wins over env vars + auto-detect.
+     * Pass `null` to opt out of all mirroring (including auto-detect).
+     */
+    localDebuggerUrl?: string | null;
 };
 declare class TraceShipper$1 {
     private baseUrl;
@@ -147,7 +152,7 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
-    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
@@ -224,22 +229,16 @@ declare class TraceShipper extends TraceShipper$1 {
     constructor(opts: ConstructorParameters<typeof TraceShipper$1>[0]);
 }
 
-/**
- * Raindrop TelemetryIntegration for AI SDK v7+
- *
- * Implements the AI SDK's TelemetryIntegration interface to capture traces and
- * events natively, replacing the Proxy-based wrapping used for v4-v6.
- *
- * Modeled after the upstream OpenTelemetryIntegration but uses Raindrop's
- * TraceShipper (OTLP/HTTP) + EventShipper instead of the OTel Tracer API.
- */
-
 type Listener<T> = (event: T) => PromiseLike<void> | void;
 interface TelemetryIntegration {
     onStart?: Listener<any>;
     onStepStart?: Listener<any>;
+    onToolExecutionStart?: Listener<any>;
+    onToolExecutionEnd?: Listener<any>;
     onToolCallStart?: Listener<any>;
     onToolCallFinish?: Listener<any>;
+    onLanguageModelCallStart?: Listener<any>;
+    onLanguageModelCallEnd?: Listener<any>;
     onChunk?: Listener<any>;
     onStepFinish?: Listener<any>;
     onEmbedStart?: Listener<any>;
@@ -287,8 +286,14 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private extractInputText;
     onStart: (event: any) => void;
     onStepStart: (event: any) => void;
+    private toolExecutionStart;
+    private toolExecutionEnd;
+    onToolExecutionStart: (event: any) => void;
+    onToolExecutionEnd: (event: any) => void;
     onToolCallStart: (event: any) => void;
     onToolCallFinish: (event: any) => void;
+    onLanguageModelCallStart: (_event: any) => void;
+    onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
@@ -309,6 +314,65 @@ type IdentifyInput = {
     traits?: Record<string, unknown>;
 };
 
+type RaindropCallMetadata = {
+    userId?: string;
+    eventId?: string;
+    /** True when the eventId was auto-generated by `eventMetadata()` rather than user-provided. */
+    eventIdGenerated?: boolean;
+    convoId?: string;
+    eventName?: string;
+    properties?: Record<string, unknown>;
+    /**
+     * Raw `metadata` record, preserved so the integration can write the
+     * full set of `raindrop.*` keys onto root spans (the trace shipper
+     * relies on this to surface metadata in the dashboard span attributes).
+     */
+    rawMetadata?: Record<string, unknown>;
+};
+declare global {
+    var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {
+        getStore(): T | undefined;
+        run<R>(store: T, callback: () => R): R;
+        enterWith?(store: T): void;
+    }) | undefined;
+}
+/** Test helper — allow tests to drop a stale fallback storage between runs. */
+declare function _resetRaindropCallMetadataStorage(): void;
+/**
+ * Returns the active per-call Raindrop metadata, or `undefined` if no
+ * call is currently in scope. Safe to call from any telemetry callback.
+ */
+declare function getCurrentRaindropCallMetadata(): RaindropCallMetadata | undefined;
+/**
+ * Runs `fn` with `metadata` bound as the active per-call Raindrop metadata.
+ * Visible to nested async work via `AsyncLocalStorage` when available.
+ */
+declare function runWithRaindropCallMetadata<R>(metadata: RaindropCallMetadata, fn: () => R): R;
+/**
+ * Inspect the first argument to an AI SDK function call (the call
+ * options object) and pull out any Raindrop metadata routed via one of:
+ *
+ *   1. top-level `metadata` — convention inherited from the v4-v6 Proxy
+ *      path (`extractRaindropCallOptions` in `wrap/wrapAISDK.ts`). Some
+ *      callers route `eventMetadata()` here to bypass framework-specific
+ *      `experimental_telemetry` typings;
+ *   2. `telemetry.metadata` — the v7 beta.111+ stable name (anticipated;
+ *      the v7 dispatcher does not currently forward `metadata`, but the
+ *      shape is what users will pass once it lands);
+ *   3. `experimental_telemetry.metadata` — the documented and currently
+ *      working channel for v6 + every published v7 beta.
+ *
+ * Priority is `(1) > (2) > (3)` to stay consistent with the v4-v6 path's
+ * `extractRaindropCallOptions`. If you ever change this order, the
+ * self-diagnostics injection in `wrapAISDK.ts` (which mutates the v3
+ * source only) becomes a re-read hazard — see the comment by
+ * `mergedAlsMetadata` in that file.
+ *
+ * Returns `undefined` when there is no Raindrop metadata to propagate,
+ * so callers can skip the ALS push entirely.
+ */
+declare function readRaindropCallMetadataFromArgs(args: readonly unknown[]): RaindropCallMetadata | undefined;
+
 declare function _resetWarnedMissingUserId(): void;
 
 /**
@@ -445,6 +509,18 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: string;
+    /**
+     * Force-enable (or opt out of) Workshop / local-debugger mirroring.
+     *
+     *   - `string` — explicit Workshop URL (e.g. `"http://localhost:5899/v1/"`),
+     *     wins over env vars and runtime auto-detect.
+     *   - `false` (or `null`) — explicit opt-out, even on localhost / when
+     *     `NODE_ENV=development` / when `RAINDROP_WORKSHOP` is set.
+     *   - `undefined` (default) — fall through to `RAINDROP_LOCAL_DEBUGGER`,
+     *     `RAINDROP_WORKSHOP`, and runtime auto-detect (localhost-ish hostname
+     *     OR `NODE_ENV=development` enables the default `:5899` daemon).
+     */
+    localWorkshopUrl?: string | false | null;
     traces?: {
         enabled?: boolean;
         flushIntervalMs?: number;
@@ -688,4 +764,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type StartSpanArgs, type TraceSpan, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type StartSpanArgs, type TraceSpan, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentRaindropCallMetadata, readRaindropCallMetadataFromArgs, runWithRaindropCallMetadata, withCurrent };

package/dist/index.browser.d.ts

@@ -130,6 +130,11 @@ type TraceShipperOptions = {
     sdkName?: string;
     serviceName?: string;
     serviceVersion?: string;
+    /**
+     * Explicit Workshop / local debugger URL. Wins over env vars + auto-detect.
+     * Pass `null` to opt out of all mirroring (including auto-detect).
+     */
+    localDebuggerUrl?: string | null;
 };
 declare class TraceShipper$1 {
     private baseUrl;
@@ -147,7 +152,7 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
-    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
@@ -224,22 +229,16 @@ declare class TraceShipper extends TraceShipper$1 {
     constructor(opts: ConstructorParameters<typeof TraceShipper$1>[0]);
 }
 
-/**
- * Raindrop TelemetryIntegration for AI SDK v7+
- *
- * Implements the AI SDK's TelemetryIntegration interface to capture traces and
- * events natively, replacing the Proxy-based wrapping used for v4-v6.
- *
- * Modeled after the upstream OpenTelemetryIntegration but uses Raindrop's
- * TraceShipper (OTLP/HTTP) + EventShipper instead of the OTel Tracer API.
- */
-
 type Listener<T> = (event: T) => PromiseLike<void> | void;
 interface TelemetryIntegration {
     onStart?: Listener<any>;
     onStepStart?: Listener<any>;
+    onToolExecutionStart?: Listener<any>;
+    onToolExecutionEnd?: Listener<any>;
     onToolCallStart?: Listener<any>;
     onToolCallFinish?: Listener<any>;
+    onLanguageModelCallStart?: Listener<any>;
+    onLanguageModelCallEnd?: Listener<any>;
     onChunk?: Listener<any>;
     onStepFinish?: Listener<any>;
     onEmbedStart?: Listener<any>;
@@ -287,8 +286,14 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private extractInputText;
     onStart: (event: any) => void;
     onStepStart: (event: any) => void;
+    private toolExecutionStart;
+    private toolExecutionEnd;
+    onToolExecutionStart: (event: any) => void;
+    onToolExecutionEnd: (event: any) => void;
     onToolCallStart: (event: any) => void;
     onToolCallFinish: (event: any) => void;
+    onLanguageModelCallStart: (_event: any) => void;
+    onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
@@ -309,6 +314,65 @@ type IdentifyInput = {
     traits?: Record<string, unknown>;
 };
 
+type RaindropCallMetadata = {
+    userId?: string;
+    eventId?: string;
+    /** True when the eventId was auto-generated by `eventMetadata()` rather than user-provided. */
+    eventIdGenerated?: boolean;
+    convoId?: string;
+    eventName?: string;
+    properties?: Record<string, unknown>;
+    /**
+     * Raw `metadata` record, preserved so the integration can write the
+     * full set of `raindrop.*` keys onto root spans (the trace shipper
+     * relies on this to surface metadata in the dashboard span attributes).
+     */
+    rawMetadata?: Record<string, unknown>;
+};
+declare global {
+    var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {
+        getStore(): T | undefined;
+        run<R>(store: T, callback: () => R): R;
+        enterWith?(store: T): void;
+    }) | undefined;
+}
+/** Test helper — allow tests to drop a stale fallback storage between runs. */
+declare function _resetRaindropCallMetadataStorage(): void;
+/**
+ * Returns the active per-call Raindrop metadata, or `undefined` if no
+ * call is currently in scope. Safe to call from any telemetry callback.
+ */
+declare function getCurrentRaindropCallMetadata(): RaindropCallMetadata | undefined;
+/**
+ * Runs `fn` with `metadata` bound as the active per-call Raindrop metadata.
+ * Visible to nested async work via `AsyncLocalStorage` when available.
+ */
+declare function runWithRaindropCallMetadata<R>(metadata: RaindropCallMetadata, fn: () => R): R;
+/**
+ * Inspect the first argument to an AI SDK function call (the call
+ * options object) and pull out any Raindrop metadata routed via one of:
+ *
+ *   1. top-level `metadata` — convention inherited from the v4-v6 Proxy
+ *      path (`extractRaindropCallOptions` in `wrap/wrapAISDK.ts`). Some
+ *      callers route `eventMetadata()` here to bypass framework-specific
+ *      `experimental_telemetry` typings;
+ *   2. `telemetry.metadata` — the v7 beta.111+ stable name (anticipated;
+ *      the v7 dispatcher does not currently forward `metadata`, but the
+ *      shape is what users will pass once it lands);
+ *   3. `experimental_telemetry.metadata` — the documented and currently
+ *      working channel for v6 + every published v7 beta.
+ *
+ * Priority is `(1) > (2) > (3)` to stay consistent with the v4-v6 path's
+ * `extractRaindropCallOptions`. If you ever change this order, the
+ * self-diagnostics injection in `wrapAISDK.ts` (which mutates the v3
+ * source only) becomes a re-read hazard — see the comment by
+ * `mergedAlsMetadata` in that file.
+ *
+ * Returns `undefined` when there is no Raindrop metadata to propagate,
+ * so callers can skip the ALS push entirely.
+ */
+declare function readRaindropCallMetadataFromArgs(args: readonly unknown[]): RaindropCallMetadata | undefined;
+
 declare function _resetWarnedMissingUserId(): void;
 
 /**
@@ -445,6 +509,18 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: string;
+    /**
+     * Force-enable (or opt out of) Workshop / local-debugger mirroring.
+     *
+     *   - `string` — explicit Workshop URL (e.g. `"http://localhost:5899/v1/"`),
+     *     wins over env vars and runtime auto-detect.
+     *   - `false` (or `null`) — explicit opt-out, even on localhost / when
+     *     `NODE_ENV=development` / when `RAINDROP_WORKSHOP` is set.
+     *   - `undefined` (default) — fall through to `RAINDROP_LOCAL_DEBUGGER`,
+     *     `RAINDROP_WORKSHOP`, and runtime auto-detect (localhost-ish hostname
+     *     OR `NODE_ENV=development` enables the default `:5899` daemon).
+     */
+    localWorkshopUrl?: string | false | null;
     traces?: {
         enabled?: boolean;
         flushIntervalMs?: number;
@@ -688,4 +764,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type StartSpanArgs, type TraceSpan, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type StartSpanArgs, type TraceSpan, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentRaindropCallMetadata, readRaindropCallMetadataFromArgs, runWithRaindropCallMetadata, withCurrent };