@raindrop-ai/ai-sdk 0.0.20 → 0.0.21

package/README.md

@@ -5,6 +5,7 @@ Standalone Vercel AI SDK integration for Raindrop:
 - **Events**: sends a `track_partial` payload to `POST /v1/events/track_partial` when the model finishes
 - **Standalone traces**: ships spans directly to `POST /v1/traces` as **OTLP/HTTP JSON**
 - **No OpenTelemetry SDK init**: avoids global OTEL registration conflicts
+- **Native v7 telemetry**: opt-in callback-based integration via AI SDK v7's `TelemetryIntegration` interface (no Proxy wrapping)
 
 ## Install
 
@@ -54,6 +55,27 @@ await raindrop.users.identify({
 await raindrop.flush();
 ```
 
+### AI SDK v7+ native telemetry (opt-in)
+
+On AI SDK v7+, you can use the native `TelemetryIntegration` callback interface instead of Proxy wrapping. This avoids Proxy overhead and works with all AI SDK entry points (including `ToolLoopAgent`).
+
+```ts
+// Option A: wrap() with nativeTelemetry flag
+const { generateText } = raindrop.wrap(ai, {
+  context: { userId: "user_123" },
+  nativeTelemetry: true,
+});
+
+// Option B: direct registration (no wrap needed)
+import { registerTelemetryIntegration } from "ai";
+
+registerTelemetryIntegration(
+  raindrop.createTelemetryIntegration({ userId: "user_123" })
+);
+```
+
+Setting `nativeTelemetry: true` on pre-v7 throws a clear error. The Proxy path remains the default and supports features not yet available on the native path (`buildEvent`, output attachment extraction).
+
 If `userId` is missing from both `wrap()` context and `eventMetadata()`, the SDK logs a warning (once) and skips sending events.
 
 ## Runtime support
@@ -101,11 +123,12 @@ but it uses the same synchronous fallback described above rather than real
 
 This package is tested against multiple Vercel AI SDK versions:
 
-| Version | Status |
-|---------|--------|
-| v4.x    | ✅ Supported |
-| v5.x    | ✅ Supported |
-| v6.x    | ✅ Supported |
+| Version | Status | Integration |
+|---------|--------|-------------|
+| v4.x    | ✅ Supported | Proxy |
+| v5.x    | ✅ Supported | Proxy |
+| v6.x    | ✅ Supported | Proxy |
+| v7.x (beta) | ✅ Supported | Proxy (default) or native `TelemetryIntegration` (opt-in) |
 
 ### Version Differences Handled
 
@@ -130,10 +153,15 @@ packages/ai-sdk/
 │   │   ├── ai-sdk.v5.test.ts
 │   │   ├── wrapper.test.ts
 │   │   └── http-payloads.test.ts
-│   └── v6/                 # AI SDK v6 (pins ai@^6.0.0)
-│       ├── ai-sdk.v6.test.ts
-│       ├── wrapper.test.ts
-│       └── http-payloads.test.ts
+│   ├── v6/                 # AI SDK v6 (pins ai@^6.0.0)
+│   │   ├── ai-sdk.v6.test.ts
+│   │   ├── wrapper.test.ts
+│   │   └── http-payloads.test.ts
+│   └── v7/                 # AI SDK v7 beta (native telemetry + proxy)
+│       ├── telemetry-integration.test.ts   # Unit tests for all callbacks
+│       ├── e2e-native-telemetry.test.ts    # E2E with real AI SDK + MSW
+│       ├── e2e-subagent-nesting.test.ts    # Subagent span hierarchy
+│       └── wrapper.test.ts
 ```
 
 ### Running Tests
@@ -146,6 +174,7 @@ pnpm test
 pnpm test:v4
 pnpm test:v5
 pnpm test:v6
+pnpm test:v7
 
 # Quick smoke test (real LLM calls, single version)
 pnpm smoke:min
@@ -158,6 +187,11 @@ Each version runs:
 - **HTTP payload tests** - MSW-based payload validation for each spec version
 - **Version-specific tests** - API differences (finishReason format, usage naming)
 
+v7 additionally runs:
+- **Telemetry integration tests** - All callback lifecycles with mock shippers
+- **E2E native telemetry** - Real AI SDK v7 with MSW-intercepted payloads
+- **Subagent nesting** - Span hierarchy for nested generateText inside tool execution
+
 ## Notes
 
 - Spans include `ai.telemetry.metadata.raindrop.eventId` for correlation, and **omit** `ai.telemetry.metadata.raindrop.userId` to prevent duplicate span→event creation server-side.

package/dist/{chunk-FD5GVIE2.mjs → chunk-BTNDCDA3.mjs}

@@ -1,6 +1,6 @@
 import { AsyncLocalStorage } from 'async_hooks';
 
-// ../core/dist/chunk-H6VSZSLN.js
+// ../core/dist/chunk-4UCYIEH4.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -145,6 +145,7 @@ async function postJson(url, body, headers, opts) {
   );
 }
 var SpanStatusCode = {
+  UNSET: 0,
   ERROR: 2
 };
 function createSpanIds(parent) {
@@ -465,11 +466,66 @@ var EventShipper = class {
     }
   }
 };
+var LOCAL_DEBUGGER_ENV_VAR = "RAINDROP_LOCAL_DEBUGGER";
+function resolveLocalDebuggerBaseUrl(baseUrl) {
+  var _a, _b, _c;
+  const resolved = (_b = baseUrl != null ? baseUrl : typeof process !== "undefined" ? (_a = process.env) == null ? void 0 : _a[LOCAL_DEBUGGER_ENV_VAR] : void 0) != null ? _b : null;
+  return resolved ? (_c = formatEndpoint(resolved)) != null ? _c : null : null;
+}
+function localDebuggerEnabled(baseUrl) {
+  return resolveLocalDebuggerBaseUrl(baseUrl) !== null;
+}
+function normalizeLocalDebuggerLiveEventType(type) {
+  switch (type) {
+    case "text-delta":
+      return "text_delta";
+    case "reasoning":
+    case "reasoning-delta":
+      return "reasoning_delta";
+    case "tool-call":
+      return "tool_start";
+    case "tool-result":
+      return "tool_result";
+    default:
+      return type;
+  }
+}
+function mirrorTraceExportToLocalDebugger(body, options = {}) {
+  var _a;
+  const baseUrl = resolveLocalDebuggerBaseUrl(options.baseUrl);
+  if (!baseUrl) return;
+  void postJson(`${baseUrl}traces`, body, {}, {
+    maxAttempts: 1,
+    debug: (_a = options.debug) != null ? _a : false,
+    sdkName: options.sdkName
+  }).catch(() => {
+  });
+}
+function sendLocalDebuggerLiveEvent(event, options = {}) {
+  var _a, _b;
+  const baseUrl = resolveLocalDebuggerBaseUrl(options.baseUrl);
+  if (!baseUrl) return;
+  void postJson(
+    `${baseUrl}live`,
+    {
+      ...event,
+      type: normalizeLocalDebuggerLiveEventType(event.type),
+      timestamp: (_a = event.timestamp) != null ? _a : Date.now()
+    },
+    {},
+    {
+      maxAttempts: 1,
+      debug: (_b = options.debug) != null ? _b : false,
+      sdkName: options.sdkName
+    }
+  ).catch(() => {
+  });
+}
 var TraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
     this.writeKey = (_a = opts.writeKey) == null ? void 0 : _a.trim();
     this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled !== false;
@@ -482,6 +538,13 @@ var TraceShipper = class {
     this.prefix = `[raindrop-ai/${this.sdkName}]`;
     this.serviceName = (_g = opts.serviceName) != null ? _g : "raindrop.core";
     this.serviceVersion = (_h = opts.serviceVersion) != null ? _h : "0.0.0";
+    const localDebugger = typeof process !== "undefined" ? (_i = process.env) == null ? void 0 : _i.RAINDROP_LOCAL_DEBUGGER : void 0;
+    if (localDebugger) {
+      this.localDebuggerUrl = (_j = resolveLocalDebuggerBaseUrl(localDebugger)) != null ? _j : void 0;
+      if (this.debug) {
+        console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
+      }
+    }
   }
   isDebugEnabled() {
     return this.debug;
@@ -498,7 +561,25 @@ var TraceShipper = class {
       attrString("ai.operationId", args.operationId)
     ];
     if ((_b = args.attributes) == null ? void 0 : _b.length) attrs.push(...args.attributes);
-    return { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    const span = { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    if (this.localDebuggerUrl) {
+      const openSpan = buildOtlpSpan({
+        ids: span.ids,
+        name: span.name,
+        startTimeUnixNano: span.startTimeUnixNano,
+        endTimeUnixNano: span.startTimeUnixNano,
+        // placeholder — will be updated on endSpan
+        attributes: span.attributes,
+        status: { code: SpanStatusCode.UNSET }
+      });
+      const body = buildExportTraceServiceRequest([openSpan], this.serviceName, this.serviceVersion);
+      mirrorTraceExportToLocalDebugger(body, {
+        baseUrl: this.localDebuggerUrl,
+        debug: false,
+        sdkName: this.sdkName
+      });
+    }
+    return span;
   }
   endSpan(span, extra) {
     var _a, _b;
@@ -521,6 +602,14 @@ var TraceShipper = class {
       status
     });
     this.enqueue(otlp);
+    if (this.localDebuggerUrl) {
+      const body = buildExportTraceServiceRequest([otlp], this.serviceName, this.serviceVersion);
+      mirrorTraceExportToLocalDebugger(body, {
+        baseUrl: this.localDebuggerUrl,
+        debug: false,
+        sdkName: this.sdkName
+      });
+    }
   }
   createSpan(args) {
     var _a;
@@ -538,6 +627,14 @@ var TraceShipper = class {
       status: args.status
     });
     this.enqueue(otlp);
+    if (this.localDebuggerUrl) {
+      const body = buildExportTraceServiceRequest([otlp], this.serviceName, this.serviceVersion);
+      mirrorTraceExportToLocalDebugger(body, {
+        baseUrl: this.localDebuggerUrl,
+        debug: false,
+        sdkName: this.sdkName
+      });
+    }
   }
   enqueue(span) {
     if (!this.enabled) return;
@@ -1517,6 +1614,7 @@ var RaindropTelemetryIntegration = class {
         ]
       });
       state.toolSpans.set(toolCall.toolCallId, toolSpan);
+      this.emitLive(state, "tool_start", toolCall.toolName, { args: toolCall.input });
     };
     // ── onToolCallFinish ────────────────────────────────────────────────────
     this.onToolCallFinish = (event) => {
@@ -1531,11 +1629,12 @@ var RaindropTelemetryIntegration = class {
       } else {
         this.traceShipper.endSpan(toolSpan, { error: event.error });
       }
+      this.emitLive(state, "tool_result", event.toolCall.toolName);
       state.toolSpans.delete(event.toolCall.toolCallId);
     };
     // ── onChunk (streaming) ─────────────────────────────────────────────────
     this.onChunk = (event) => {
-      var _a, _b, _c;
+      var _a, _b, _c, _d, _e;
       const callId = (_b = event.callId) != null ? _b : (_a = event.chunk) == null ? void 0 : _a.callId;
       if (!callId) return;
       const state = this.getState(callId);
@@ -1546,6 +1645,12 @@ var RaindropTelemetryIntegration = class {
         const delta = (_c = chunk.textDelta) != null ? _c : chunk.delta;
         if (typeof delta === "string") {
           state.accumulatedText += delta;
+          this.emitLive(state, "text_delta", delta);
+        }
+      } else if (chunk.type === "reasoning" || chunk.type === "reasoning-delta") {
+        const text = (_e = (_d = chunk.textDelta) != null ? _d : chunk.text) != null ? _e : chunk.delta;
+        if (typeof text === "string") {
+          this.emitLive(state, "reasoning_delta", text);
         }
       }
     };
@@ -1733,6 +1838,23 @@ var RaindropTelemetryIntegration = class {
   spanParentRef(span) {
     return { traceIdB64: span.ids.traceIdB64, spanIdB64: span.ids.spanIdB64 };
   }
+  emitLive(state, type, content, extra) {
+    var _a, _b, _c, _d, _e, _f;
+    if (!localDebuggerEnabled() || !state.rootSpan) return;
+    const callMeta = this.extractRaindropMetadata(state.metadata);
+    sendLocalDebuggerLiveEvent({
+      traceId: state.rootSpan.ids.traceIdB64,
+      type,
+      content,
+      metadata: {
+        userId: (_b = callMeta.userId) != null ? _b : (_a = this.defaultContext) == null ? void 0 : _a.userId,
+        convoId: (_d = callMeta.convoId) != null ? _d : (_c = this.defaultContext) == null ? void 0 : _c.convoId,
+        eventName: (_f = callMeta.eventName) != null ? _f : (_e = this.defaultContext) == null ? void 0 : _e.eventName,
+        eventId: state.eventId,
+        ...extra
+      }
+    });
+  }
   extractRaindropMetadata(metadata) {
     if (!metadata) return {};
     const result = {};
@@ -2265,6 +2387,36 @@ function shouldKeepEventPending(params) {
   if (params.error != null || !params.canKeepEventPending) return false;
   return params.finishReason === "tool-calls" || params.finishReason === "tool_calls";
 }
+function normalizePromptAttr(arg) {
+  if (!isRecord(arg)) return arg;
+  const system = arg["system"];
+  const prompt = arg["prompt"];
+  const messages = arg["messages"];
+  if (Array.isArray(messages)) {
+    if (system) {
+      const sysContent = typeof system === "string" ? system : JSON.stringify(system);
+      return [{ role: "system", content: sysContent }, ...messages];
+    }
+    return messages;
+  }
+  if (typeof prompt === "string") {
+    const msgs = [];
+    if (system) {
+      msgs.push({ role: "system", content: typeof system === "string" ? system : JSON.stringify(system) });
+    }
+    msgs.push({ role: "user", content: prompt });
+    return msgs;
+  }
+  return { system, prompt, messages };
+}
+function getLocalDebuggerMetadata(ctx) {
+  return {
+    eventId: ctx.eventId,
+    ...ctx.eventName ? { eventName: ctx.eventName } : {},
+    ...ctx.userId ? { userId: ctx.userId } : {},
+    ...ctx.convoId ? { convoId: ctx.convoId } : {}
+  };
+}
 async function safeFinalize(finalize, debug, result, error) {
   try {
     await finalize(result, error);
@@ -2337,17 +2489,17 @@ function setupOperation(params) {
       attrString("ai.telemetry.functionId", telemetry == null ? void 0 : telemetry.functionId),
       attrString("ai.model.provider", modelInfoFromArgs.provider),
       attrString("ai.model.id", modelInfoFromArgs.modelId),
+      attrString("ai.telemetry.metadata.raindrop.eventId", eventId),
+      attrString("ai.telemetry.metadata.raindrop.eventName", mergedCtx.eventName),
+      attrString("ai.telemetry.metadata.raindrop.userId", mergedCtx.userId),
+      attrString("ai.telemetry.metadata.raindrop.convoId", mergedCtx.convoId),
       ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
       ...attrsFromHeaders(isRecord(arg) ? arg["headers"] : void 0),
       ...attrsFromSettings(arg),
       ...(telemetry == null ? void 0 : telemetry.recordInputs) === false ? [] : [
         attrString(
           "ai.prompt",
-          safeJsonWithUint8({
-            system: isRecord(arg) ? arg["system"] : void 0,
-            prompt: isRecord(arg) ? arg["prompt"] : void 0,
-            messages: isRecord(arg) ? arg["messages"] : void 0
-          })
+          safeJsonWithUint8(normalizePromptAttr(arg))
         )
       ]
     ]
@@ -2356,6 +2508,7 @@ function setupOperation(params) {
   const operationSelfDiagnostics = isObjectOperation(operation) ? void 0 : selfDiagnostics;
   const wrapCtx = {
     eventId,
+    context: mergedCtx,
     telemetry,
     sendTraces,
     debug,
@@ -2730,6 +2883,7 @@ function wrapAISDK(aiSDK, deps) {
             const perCallEventIdGenerated = !perCallEventIdExplicit;
             const perCallCtx = {
               eventId: perCallEventId,
+              context: wrapTimeCtx,
               telemetry,
               sendTraces: false,
               debug,
@@ -2884,7 +3038,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
     const eventId = (_c = (_b2 = (_a2 = callTimeCtx.eventId) != null ? _a2 : mergedCtx.eventId) != null ? _b2 : inherited == null ? void 0 : inherited.eventId) != null ? _c : randomUUID();
-    const ctx = { ...mergedCtx};
+    const ctx = { ...mergedCtx, eventId };
     const inheritedParent = inherited && inherited.eventId === eventId ? { traceIdB64: inherited.traceIdB64, spanIdB64: inherited.spanIdB64 } : void 0;
     const outerOperationId = `ai.${operation}`;
     const { operationName, resourceName } = opName(outerOperationId, telemetry == null ? void 0 : telemetry.functionId);
@@ -2900,17 +3054,17 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         attrString("ai.telemetry.functionId", telemetry == null ? void 0 : telemetry.functionId),
         attrString("ai.model.provider", modelInfoFromArgs.provider),
         attrString("ai.model.id", modelInfoFromArgs.modelId),
+        attrString("ai.telemetry.metadata.raindrop.eventId", eventId),
+        attrString("ai.telemetry.metadata.raindrop.eventName", ctx.eventName),
+        attrString("ai.telemetry.metadata.raindrop.userId", ctx.userId),
+        attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
         ...attrsFromSettings(mergedArgs),
         ...(telemetry == null ? void 0 : telemetry.recordInputs) === false ? [] : [
           attrString(
             "ai.prompt",
-            safeJsonWithUint8({
-              system: (_d = mergedArgs["system"]) != null ? _d : mergedArgs["instructions"],
-              prompt: mergedArgs["prompt"],
-              messages: mergedArgs["messages"]
-            })
+            safeJsonWithUint8(normalizePromptAttr({ system: (_d = mergedArgs["system"]) != null ? _d : mergedArgs["instructions"], prompt: mergedArgs["prompt"], messages: mergedArgs["messages"] }))
           )
         ]
       ]
@@ -2918,6 +3072,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
     const rootParentForChildren = rootSpan ? { traceIdB64: rootSpan.ids.traceIdB64, spanIdB64: rootSpan.ids.spanIdB64 } : inheritedParent;
     const wrapCtx = {
       eventId,
+      context: ctx,
       telemetry,
       sendTraces,
       debug,
@@ -3091,7 +3246,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
     const eventId = (_c = (_b2 = (_a2 = callTimeCtx.eventId) != null ? _a2 : mergedCtx.eventId) != null ? _b2 : inherited == null ? void 0 : inherited.eventId) != null ? _c : randomUUID();
-    const ctx = { ...mergedCtx};
+    const ctx = { ...mergedCtx, eventId };
     const inheritedParent = inherited && inherited.eventId === eventId ? { traceIdB64: inherited.traceIdB64, spanIdB64: inherited.spanIdB64 } : void 0;
     const outerOperationId = `ai.${operation}`;
     const { operationName, resourceName } = opName(outerOperationId, telemetry == null ? void 0 : telemetry.functionId);
@@ -3107,17 +3262,17 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         attrString("ai.telemetry.functionId", telemetry == null ? void 0 : telemetry.functionId),
         attrString("ai.model.provider", modelInfoFromArgs.provider),
         attrString("ai.model.id", modelInfoFromArgs.modelId),
+        attrString("ai.telemetry.metadata.raindrop.eventId", eventId),
+        attrString("ai.telemetry.metadata.raindrop.eventName", ctx.eventName),
+        attrString("ai.telemetry.metadata.raindrop.userId", ctx.userId),
+        attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
         ...attrsFromSettings(mergedArgs),
         ...(telemetry == null ? void 0 : telemetry.recordInputs) === false ? [] : [
           attrString(
             "ai.prompt",
-            safeJsonWithUint8({
-              system: (_d = mergedArgs["system"]) != null ? _d : mergedArgs["instructions"],
-              prompt: mergedArgs["prompt"],
-              messages: mergedArgs["messages"]
-            })
+            safeJsonWithUint8(normalizePromptAttr({ system: (_d = mergedArgs["system"]) != null ? _d : mergedArgs["instructions"], prompt: mergedArgs["prompt"], messages: mergedArgs["messages"] }))
           )
         ]
       ]
@@ -3125,6 +3280,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
     const rootParentForChildren = rootSpan ? { traceIdB64: rootSpan.ids.traceIdB64, spanIdB64: rootSpan.ids.spanIdB64 } : inheritedParent;
     const wrapCtx = {
       eventId,
+      context: ctx,
       telemetry,
       sendTraces,
       debug,
@@ -3348,6 +3504,21 @@ function wrapToolExecute(name, tool, ctx, toolCalls) {
       });
     }
   };
+  const sendToolLiveEvent = (parent, type, metadata) => {
+    if (!localDebuggerEnabled() || !parent) return;
+    sendLocalDebuggerLiveEvent({
+      traceId: parent.traceIdB64,
+      type,
+      content: name,
+      metadata: {
+        ...getLocalDebuggerMetadata({
+          ...ctx.context,
+          eventId: ctx.eventId
+        }),
+        ...metadata
+      }
+    });
+  };
   const createContextSpan = (span) => ({
     traceIdB64: span.ids.traceIdB64,
     spanIdB64: span.ids.spanIdB64,
@@ -3363,6 +3534,7 @@ function wrapToolExecute(name, tool, ctx, toolCalls) {
         const parentCtx = await getCurrentParentSpanContext();
         const parent = parentCtx && parentCtx.eventId === ctx.eventId ? { traceIdB64: parentCtx.traceIdB64, spanIdB64: parentCtx.spanIdB64 } : ctx.rootParentForChildren;
         const toolSpan = createToolSpan(toolCallId, toolArgs, parent);
+        sendToolLiveEvent(parent, "tool_start", { args: toolArgs });
         try {
           let lastValue;
           const iterator = result[Symbol.asyncIterator]();
@@ -3378,9 +3550,13 @@ function wrapToolExecute(name, tool, ctx, toolCalls) {
           }
           toolCalls.push({ id: toolCallId, name, args: toolArgs, result: lastValue, status: "OK" });
           endToolSpan(toolSpan, lastValue);
+          sendToolLiveEvent(parent, "tool_result", { result: lastValue });
         } catch (error) {
           toolCalls.push({ id: toolCallId, name, args: toolArgs, status: "ERROR" });
           endToolSpan(toolSpan, void 0, error);
+          sendToolLiveEvent(parent, "tool_result", {
+            error: error instanceof Error ? error.message : String(error)
+          });
           throw error;
         }
       })();
@@ -3389,6 +3565,7 @@ function wrapToolExecute(name, tool, ctx, toolCalls) {
       const parentCtx = await getCurrentParentSpanContext();
       const parent = parentCtx && parentCtx.eventId === ctx.eventId ? { traceIdB64: parentCtx.traceIdB64, spanIdB64: parentCtx.spanIdB64 } : ctx.rootParentForChildren;
       const toolSpan = createToolSpan(toolCallId, toolArgs, parent);
+      sendToolLiveEvent(parent, "tool_start", { args: toolArgs });
       const run = async () => {
         try {
           const awaitedResult = await result;
@@ -3400,10 +3577,14 @@ function wrapToolExecute(name, tool, ctx, toolCalls) {
             status: "OK"
           });
           endToolSpan(toolSpan, awaitedResult);
+          sendToolLiveEvent(parent, "tool_result", { result: awaitedResult });
           return awaitedResult;
         } catch (error) {
           toolCalls.push({ id: toolCallId, name, args: toolArgs, status: "ERROR" });
           endToolSpan(toolSpan, void 0, error);
+          sendToolLiveEvent(parent, "tool_result", {
+            error: error instanceof Error ? error.message : String(error)
+          });
           throw error;
         }
       };
@@ -3443,6 +3624,7 @@ function wrapModel(args, aiSDK, outerOperationId, ctx) {
       const original = Reflect.get(target, prop, receiver);
       if (prop === "doGenerate" && isFunction(original)) {
         return async (...callArgs) => {
+          var _a, _b;
           const options = callArgs[0];
           const parentCtx = await getCurrentParentSpanContext();
           const parent = parentCtx && parentCtx.eventId === ctx.eventId ? { traceIdB64: parentCtx.traceIdB64, spanIdB64: parentCtx.spanIdB64 } : ctx.rootParentForChildren;
@@ -3450,6 +3632,22 @@ function wrapModel(args, aiSDK, outerOperationId, ctx) {
           try {
             const result = await original.apply(target, callArgs);
             if (span) endDoGenerateSpan(span, result, modelInfo, ctx);
+            if (localDebuggerEnabled() && ctx.rootParentForChildren && isRecord(result)) {
+              const traceId = ctx.rootParentForChildren.traceIdB64;
+              const liveMeta = getLocalDebuggerMetadata({ ...ctx.context, eventId: ctx.eventId });
+              const content = result["content"];
+              if (Array.isArray(content)) {
+                for (const part of content) {
+                  if (isRecord(part)) {
+                    if ((part["type"] === "reasoning" || part["type"] === "thinking") && typeof ((_a = part["text"]) != null ? _a : part["thinking"]) === "string") {
+                      sendLocalDebuggerLiveEvent({ traceId, type: "reasoning_delta", content: (_b = part["text"]) != null ? _b : part["thinking"], metadata: liveMeta });
+                    } else if (part["type"] === "text" && typeof part["text"] === "string") {
+                      sendLocalDebuggerLiveEvent({ traceId, type: "text_delta", content: part["text"], metadata: liveMeta });
+                    }
+                  }
+                }
+              }
+            }
             return result;
           } catch (error) {
             if (span)
@@ -3589,6 +3787,23 @@ function wrapModel(args, aiSDK, outerOperationId, ctx) {
                   }
                   if ("usage" in value) usage = value["usage"];
                   if ("providerMetadata" in value) providerMetadata = value["providerMetadata"];
+                  if (localDebuggerEnabled() && ctx.rootParentForChildren) {
+                    const traceId = ctx.rootParentForChildren.traceIdB64;
+                    const liveMeta = getLocalDebuggerMetadata({ ...ctx.context, eventId: ctx.eventId });
+                    if (type === "text-delta") {
+                      const text = typeof value["delta"] === "string" ? value["delta"] : typeof value["textDelta"] === "string" ? value["textDelta"] : typeof value["text"] === "string" ? value["text"] : void 0;
+                      if (typeof text === "string" && text) sendLocalDebuggerLiveEvent({ traceId, type: "text_delta", content: text, metadata: liveMeta });
+                    } else if (type === "reasoning" || type === "reasoning-delta") {
+                      const text = typeof value["delta"] === "string" ? value["delta"] : typeof value["text"] === "string" ? value["text"] : typeof value["thinking"] === "string" ? value["thinking"] : void 0;
+                      if (typeof text === "string" && text) sendLocalDebuggerLiveEvent({ traceId, type: "reasoning_delta", content: text, metadata: liveMeta });
+                    } else if (type === "tool-call") {
+                      const toolName = typeof value["toolName"] === "string" ? value["toolName"] : "tool";
+                      sendLocalDebuggerLiveEvent({ traceId, type: "tool_start", content: toolName, metadata: { ...liveMeta, args: value["args"] } });
+                    } else if (type === "tool-result") {
+                      const toolName = typeof value["toolName"] === "string" ? value["toolName"] : "tool";
+                      sendLocalDebuggerLiveEvent({ traceId, type: "tool_result", content: toolName, metadata: { ...liveMeta, result: value["result"] } });
+                    }
+                  }
                 }
                 controller.enqueue(value);
               } catch (error) {
@@ -3789,7 +4004,7 @@ function extractNestedTokens(usage, key) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.20"};
+  version: "0.0.21"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;

package/dist/{index-DGziajf_.d.mts → index-CPArLupC.d.mts}

@@ -147,6 +147,8 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
+    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
@@ -276,6 +278,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private getState;
     private cleanup;
     private spanParentRef;
+    private emitLive;
     private extractRaindropMetadata;
     /**
      * Extract the user-facing input text from an onStart event.

package/dist/{index-DGziajf_.d.ts → index-CPArLupC.d.ts}

@@ -147,6 +147,8 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
+    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
@@ -276,6 +278,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private getState;
     private cleanup;
     private spanParentRef;
+    private emitLive;
     private extractRaindropMetadata;
     /**
      * Extract the user-facing input text from an onStart event.

package/dist/index.browser.d.mts

@@ -147,6 +147,8 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
+    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
@@ -276,6 +278,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private getState;
     private cleanup;
     private spanParentRef;
+    private emitLive;
     private extractRaindropMetadata;
     /**
      * Extract the user-facing input text from an onStart event.

package/dist/index.browser.d.ts

@@ -147,6 +147,8 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
+    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
@@ -276,6 +278,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private getState;
     private cleanup;
     private spanParentRef;
+    private emitLive;
     private extractRaindropMetadata;
     /**
      * Extract the user-facing input text from an onStart event.