@raindrop-ai/ai-sdk 0.0.20 → 0.0.22

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-7NLWLLB4.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) {
@@ -159,6 +160,9 @@ function createSpanIds(parent) {
 function nowUnixNanoString() {
   return Date.now().toString() + "000000";
 }
+function unixMsToNanoString(ms) {
+  return String(Math.floor(ms)) + "000000";
+}
 function attrString(key, value) {
   if (value === void 0) return void 0;
   return { key, value: { stringValue: value } };
@@ -465,11 +469,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 +541,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 +564,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 +605,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 +630,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 +1617,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 +1632,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 +1648,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 +1841,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 +2390,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 +2492,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 +2511,7 @@ function setupOperation(params) {
   const operationSelfDiagnostics = isObjectOperation(operation) ? void 0 : selfDiagnostics;
   const wrapCtx = {
     eventId,
+    context: mergedCtx,
     telemetry,
     sendTraces,
     debug,
@@ -2730,6 +2886,7 @@ function wrapAISDK(aiSDK, deps) {
             const perCallEventIdGenerated = !perCallEventIdExplicit;
             const perCallCtx = {
               eventId: perCallEventId,
+              context: wrapTimeCtx,
               telemetry,
               sendTraces: false,
               debug,
@@ -2884,7 +3041,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 +3057,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 +3075,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 +3249,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 +3265,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 +3283,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 +3507,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 +3537,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 +3553,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 +3568,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 +3580,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 +3627,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 +3635,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 +3790,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 +4007,7 @@ function extractNestedTokens(usage, key) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.20"};
+  version: "0.0.22"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -3861,6 +4079,14 @@ function eventMetadataFromChatRequest(options) {
     ...eventId ? { eventId } : {}
   });
 }
+function stringify(v) {
+  if (typeof v === "string") return v;
+  return JSON.stringify(v);
+}
+function userAttrsToOtlp(attrs) {
+  if (!attrs) return [];
+  return Object.entries(attrs).map(([key, value]) => attrString(key, value));
+}
 function envDebugEnabled() {
   var _a;
   if (typeof process === "undefined") return false;
@@ -3929,6 +4155,76 @@ function createRaindropAISDK(opts) {
         await eventShipper.finish(eventId, patch);
       }
     },
+    traces: /* @__PURE__ */ (() => {
+      const openSpans = /* @__PURE__ */ new Map();
+      function toTraceSpan(internal) {
+        return { traceId: internal.ids.traceIdB64, spanId: internal.ids.spanIdB64 };
+      }
+      return {
+        startSpan(args) {
+          const parent = args.parent ? { traceIdB64: args.parent.traceId, spanIdB64: args.parent.spanId } : void 0;
+          const attrs = userAttrsToOtlp(args.attributes);
+          if (args.operationId === "ai.toolCall") {
+            attrs.push(attrString("ai.toolCall.name", args.name));
+          }
+          const internal = traceShipper.startSpan({
+            name: args.name,
+            eventId: args.eventId,
+            parent,
+            operationId: args.operationId,
+            attributes: attrs
+          });
+          const handle = toTraceSpan(internal);
+          openSpans.set(handle.spanId, internal);
+          return handle;
+        },
+        endSpan(span, extra) {
+          const internal = openSpans.get(span.spanId);
+          if (!internal) return;
+          openSpans.delete(span.spanId);
+          const errorValue = extra == null ? void 0 : extra.error;
+          const error = errorValue instanceof Error ? errorValue : typeof errorValue === "string" ? new Error(errorValue) : void 0;
+          traceShipper.endSpan(internal, {
+            attributes: userAttrsToOtlp(extra == null ? void 0 : extra.attributes),
+            error
+          });
+        },
+        createSpan(args) {
+          var _a2;
+          const parent = args.parent ? { traceIdB64: args.parent.traceId, spanIdB64: args.parent.spanId } : void 0;
+          const startMs = (_a2 = args.startTime) != null ? _a2 : Date.now() - args.durationMs;
+          const startAttrs = [...userAttrsToOtlp(args.attributes)];
+          if (args.operationId === "ai.toolCall") {
+            startAttrs.push(attrString("ai.toolCall.name", args.name));
+          }
+          if (args.input !== void 0) startAttrs.push(attrString("traceloop.entity.input", stringify(args.input)));
+          if (args.operationId === "ai.toolCall" && args.input !== void 0) {
+            startAttrs.push(attrString("ai.toolCall.args", stringify(args.input)));
+          }
+          const internal = traceShipper.startSpan({
+            name: args.name,
+            eventId: args.eventId,
+            parent,
+            operationId: args.operationId,
+            attributes: startAttrs,
+            startTimeUnixNano: unixMsToNanoString(startMs)
+          });
+          const endAttrs = [];
+          if (args.output !== void 0) endAttrs.push(attrString("traceloop.entity.output", stringify(args.output)));
+          if (args.operationId === "ai.toolCall" && args.output !== void 0) {
+            endAttrs.push(attrString("ai.toolCall.result", stringify(args.output)));
+          }
+          const errorValue = args.error;
+          const error = errorValue instanceof Error ? errorValue : typeof errorValue === "string" ? new Error(errorValue) : void 0;
+          traceShipper.endSpan(internal, {
+            attributes: endAttrs,
+            error,
+            endTimeUnixNano: unixMsToNanoString(startMs + args.durationMs)
+          });
+          return toTraceSpan(internal);
+        }
+      };
+    })(),
     users: {
       async identify(users) {
         await eventShipper.identify(users);