@raindrop-ai/ai-sdk 0.0.20 → 0.0.22

package/dist/index.browser.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// ../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;
@@ -732,7 +832,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // 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;
@@ -1538,6 +1638,7 @@ var RaindropTelemetryIntegration = class {
         ]
       });
       state.toolSpans.set(toolCall.toolCallId, toolSpan);
+      this.emitLive(state, "tool_start", toolCall.toolName, { args: toolCall.input });
     };
     // ── onToolCallFinish ────────────────────────────────────────────────────
     this.onToolCallFinish = (event) => {
@@ -1552,11 +1653,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);
@@ -1567,6 +1669,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);
         }
       }
     };
@@ -1754,6 +1862,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 = {};
@@ -2299,6 +2424,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);
@@ -2371,17 +2526,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))
         )
       ]
     ]
@@ -2390,6 +2545,7 @@ function setupOperation(params) {
   const operationSelfDiagnostics = isObjectOperation(operation) ? void 0 : selfDiagnostics;
   const wrapCtx = {
     eventId,
+    context: mergedCtx,
     telemetry,
     sendTraces,
     debug,
@@ -2764,6 +2920,7 @@ function wrapAISDK(aiSDK, deps) {
             const perCallEventIdGenerated = !perCallEventIdExplicit;
             const perCallCtx = {
               eventId: perCallEventId,
+              context: wrapTimeCtx,
               telemetry,
               sendTraces: false,
               debug,
@@ -2918,7 +3075,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);
@@ -2934,17 +3091,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"] }))
           )
         ]
       ]
@@ -2952,6 +3109,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,
@@ -3125,7 +3283,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);
@@ -3141,17 +3299,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"] }))
           )
         ]
       ]
@@ -3159,6 +3317,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,
@@ -3382,6 +3541,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,
@@ -3397,6 +3571,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]();
@@ -3412,9 +3587,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;
         }
       })();
@@ -3423,6 +3602,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;
@@ -3434,10 +3614,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;
         }
       };
@@ -3477,6 +3661,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;
@@ -3484,6 +3669,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)
@@ -3623,6 +3824,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) {
@@ -3860,6 +4078,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;
@@ -3928,6 +4154,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);