@raindrop-ai/ai-sdk 0.0.21 → 0.0.23

package/README.md

@@ -192,6 +192,135 @@ v7 additionally runs:
 - **E2E native telemetry** - Real AI SDK v7 with MSW-intercepted payloads
 - **Subagent nesting** - Span hierarchy for nested generateText inside tool execution
 
+## Manual Traces
+
+Create trace spans manually alongside (or instead of) auto-instrumented ones. Useful for custom operations, DSL command extraction, or building trace trees for custom agent loops.
+
+Spans share the same trace tree as auto-instrumented spans when you pass matching `eventId` values.
+
+All three methods are available on every entrypoint (`.`, `./workers`, `./browser`).
+
+### One-shot spans
+
+Use `createSpan` when the operation is already complete and you know the duration:
+
+```ts
+raindrop.traces.createSpan({
+  name: "SET theme=dark",
+  eventId: "evt_123",
+  operationId: "ai.toolCall", // appears as a tool call in the dashboard
+  input: "SET theme=dark",
+  output: "OK",
+  durationMs: 12,
+});
+
+// Failed span
+raindrop.traces.createSpan({
+  name: "SET layout=invalid",
+  eventId: "evt_123",
+  operationId: "ai.toolCall",
+  input: "SET layout=invalid",
+  error: "Invalid layout value",
+  durationMs: 8,
+});
+```
+
+### Lifecycle spans
+
+Use `startSpan` / `endSpan` to time an operation in real time:
+
+```ts
+const span = raindrop.traces.startSpan({
+  name: "database_query",
+  eventId: "evt_123",
+  operationId: "ai.toolCall",
+});
+
+try {
+  const result = await db.query("SELECT ...");
+  raindrop.traces.endSpan(span);
+} catch (err) {
+  raindrop.traces.endSpan(span, { error: err });
+}
+```
+
+### Nested spans
+
+Pass a span as `parent` to build a trace tree:
+
+```ts
+const eventId = "evt_456";
+
+const agentTurn = raindrop.traces.startSpan({ name: "agent_turn", eventId });
+
+const subagent = raindrop.traces.startSpan({
+  name: "search_subagent",
+  eventId,
+  parent: agentTurn,
+});
+
+raindrop.traces.createSpan({
+  name: "grep_search",
+  eventId,
+  parent: subagent,
+  operationId: "ai.toolCall",
+  input: { pattern: "execute" },
+  output: { matches: 12 },
+  durationMs: 120,
+});
+
+raindrop.traces.endSpan(subagent);
+raindrop.traces.endSpan(agentTurn);
+
+await raindrop.flush();
+```
+
+### Mixing with auto-instrumented spans
+
+Use the same `eventId` for both `wrap()` calls and manual spans — they appear in the same trace tree:
+
+```ts
+const eventId = crypto.randomUUID();
+const { generateText } = raindrop.wrap(ai, {
+  context: { userId: "user_123" },
+});
+
+await generateText({
+  model: openai("gpt-4o"),
+  prompt: "Analyze this data",
+  experimental_telemetry: {
+    isEnabled: true,
+    metadata: eventMetadata({ eventId }),
+  },
+});
+
+raindrop.traces.createSpan({
+  name: "post_processing",
+  eventId,
+  input: "raw",
+  output: "processed",
+  durationMs: 50,
+});
+
+await raindrop.flush();
+```
+
+### API reference
+
+| Method | Description |
+|--------|-------------|
+| `raindrop.traces.createSpan(args)` | One-shot span with known duration |
+| `raindrop.traces.startSpan(args)` | Start a span, returns a `TraceSpan` handle |
+| `raindrop.traces.endSpan(span, extra?)` | Close a span opened with `startSpan` |
+
+**`createSpan` args:** `name`, `eventId`, `operationId?`, `parent?`, `input?`, `output?`, `durationMs`, `error?`
+
+**`startSpan` args:** `name`, `eventId`, `operationId?`, `parent?`
+
+**`endSpan` extra:** `error?` (`Error | string`)
+
+Set `operationId: "ai.toolCall"` to make spans appear as tool calls in the Raindrop dashboard.
+
 ## 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-BTNDCDA3.mjs → chunk-VQZMQSBQ.mjs}

@@ -160,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 } };
@@ -4004,7 +4007,7 @@ function extractNestedTokens(usage, key) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.21"};
+  version: "0.0.23"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -4076,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;
@@ -4144,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);

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

@@ -551,6 +551,53 @@ type WrapAISDKOptions = {
      */
     nativeTelemetry?: boolean;
 };
+/**
+ * Opaque handle for a trace span. Pass as `parent` when creating child spans.
+ */
+type TraceSpan = {
+    readonly traceId: string;
+    readonly spanId: string;
+};
+type StartSpanArgs = {
+    /** Span name (e.g. "web_search", "finder_subagent"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall", "ai.generateText"). Helps classify the span. */
+    operationId?: string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
+type EndSpanArgs = {
+    /** Additional attributes to add when ending. */
+    attributes?: Record<string, string>;
+    /** Mark the span as failed. */
+    error?: Error | string;
+};
+type CreateSpanArgs = {
+    /** Span name (e.g. "SET theme=dark", "grep_search"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall"). Helps classify the span. */
+    operationId?: string;
+    /** Input data (will be JSON stringified if object). */
+    input?: unknown;
+    /** Output data (will be JSON stringified if object). */
+    output?: unknown;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Start time as epoch ms. Defaults to `Date.now() - durationMs`. */
+    startTime?: number;
+    /** Mark the span as failed. */
+    error?: Error | string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
 type EventPatch = {
     eventName?: string;
     userId?: string;
@@ -580,6 +627,46 @@ type RaindropAISDKClient = {
             properties?: Record<string, unknown>;
         }): Promise<void>;
     };
+    /**
+     * Manually create trace spans alongside (or instead of) auto-instrumented ones.
+     *
+     * Use `startSpan` / `endSpan` for spans with manual lifecycle control, or
+     * `createSpan` for one-shot spans where timing is already known.
+     *
+     * Spans share the same trace tree as auto-instrumented spans when you pass
+     * matching `eventId` values. Use `parent` to nest spans arbitrarily.
+     *
+     * @example
+     * ```typescript
+     * // One-shot span for a DSL command extracted from agent output
+     * raindrop.traces.createSpan({
+     *   name: "SET theme=dark",
+     *   eventId: "evt_123",
+     *   operationId: "ai.toolCall",
+     *   input: "SET theme=dark",
+     *   output: "OK",
+     *   durationMs: 12,
+     * });
+     *
+     * // Manual lifecycle for a subagent
+     * const agent = raindrop.traces.startSpan({
+     *   name: "finder_subagent",
+     *   eventId: "evt_456",
+     * });
+     * const tool = raindrop.traces.startSpan({
+     *   name: "grep_search",
+     *   eventId: "evt_456",
+     *   parent: agent,
+     * });
+     * raindrop.traces.endSpan(tool);
+     * raindrop.traces.endSpan(agent);
+     * ```
+     */
+    traces: {
+        startSpan(args: StartSpanArgs): TraceSpan;
+        endSpan(span: TraceSpan, extra?: EndSpanArgs): void;
+        createSpan(args: CreateSpanArgs): TraceSpan;
+    };
     users: {
         identify(users: IdentifyInput | IdentifyInput[]): Promise<void>;
     };
@@ -601,4 +688,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, type EventBuilder as E, type IdentifyInput as I, type RaindropAISDKClient as R, type SelfDiagnosticsOptions as S, 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 EventMetadataOptions as g, type RaindropAISDKContext as h, type RaindropAISDKOptions as i, RaindropTelemetryIntegration as j, type RaindropTelemetryIntegrationOptions as k, type SelfDiagnosticsSignalDefinition as l, type SelfDiagnosticsSignalDefinitions as m, type WrappedAI as n, type WrappedAISDK as o, createRaindropAISDK as p, currentSpan as q, eventMetadata as r, eventMetadataFromChatRequest as s, getContextManager as t, withCurrent as w };
+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 };

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

@@ -551,6 +551,53 @@ type WrapAISDKOptions = {
      */
     nativeTelemetry?: boolean;
 };
+/**
+ * Opaque handle for a trace span. Pass as `parent` when creating child spans.
+ */
+type TraceSpan = {
+    readonly traceId: string;
+    readonly spanId: string;
+};
+type StartSpanArgs = {
+    /** Span name (e.g. "web_search", "finder_subagent"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall", "ai.generateText"). Helps classify the span. */
+    operationId?: string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
+type EndSpanArgs = {
+    /** Additional attributes to add when ending. */
+    attributes?: Record<string, string>;
+    /** Mark the span as failed. */
+    error?: Error | string;
+};
+type CreateSpanArgs = {
+    /** Span name (e.g. "SET theme=dark", "grep_search"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall"). Helps classify the span. */
+    operationId?: string;
+    /** Input data (will be JSON stringified if object). */
+    input?: unknown;
+    /** Output data (will be JSON stringified if object). */
+    output?: unknown;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Start time as epoch ms. Defaults to `Date.now() - durationMs`. */
+    startTime?: number;
+    /** Mark the span as failed. */
+    error?: Error | string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
 type EventPatch = {
     eventName?: string;
     userId?: string;
@@ -580,6 +627,46 @@ type RaindropAISDKClient = {
             properties?: Record<string, unknown>;
         }): Promise<void>;
     };
+    /**
+     * Manually create trace spans alongside (or instead of) auto-instrumented ones.
+     *
+     * Use `startSpan` / `endSpan` for spans with manual lifecycle control, or
+     * `createSpan` for one-shot spans where timing is already known.
+     *
+     * Spans share the same trace tree as auto-instrumented spans when you pass
+     * matching `eventId` values. Use `parent` to nest spans arbitrarily.
+     *
+     * @example
+     * ```typescript
+     * // One-shot span for a DSL command extracted from agent output
+     * raindrop.traces.createSpan({
+     *   name: "SET theme=dark",
+     *   eventId: "evt_123",
+     *   operationId: "ai.toolCall",
+     *   input: "SET theme=dark",
+     *   output: "OK",
+     *   durationMs: 12,
+     * });
+     *
+     * // Manual lifecycle for a subagent
+     * const agent = raindrop.traces.startSpan({
+     *   name: "finder_subagent",
+     *   eventId: "evt_456",
+     * });
+     * const tool = raindrop.traces.startSpan({
+     *   name: "grep_search",
+     *   eventId: "evt_456",
+     *   parent: agent,
+     * });
+     * raindrop.traces.endSpan(tool);
+     * raindrop.traces.endSpan(agent);
+     * ```
+     */
+    traces: {
+        startSpan(args: StartSpanArgs): TraceSpan;
+        endSpan(span: TraceSpan, extra?: EndSpanArgs): void;
+        createSpan(args: CreateSpanArgs): TraceSpan;
+    };
     users: {
         identify(users: IdentifyInput | IdentifyInput[]): Promise<void>;
     };
@@ -601,4 +688,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, type EventBuilder as E, type IdentifyInput as I, type RaindropAISDKClient as R, type SelfDiagnosticsOptions as S, 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 EventMetadataOptions as g, type RaindropAISDKContext as h, type RaindropAISDKOptions as i, RaindropTelemetryIntegration as j, type RaindropTelemetryIntegrationOptions as k, type SelfDiagnosticsSignalDefinition as l, type SelfDiagnosticsSignalDefinitions as m, type WrappedAI as n, type WrappedAISDK as o, createRaindropAISDK as p, currentSpan as q, eventMetadata as r, eventMetadataFromChatRequest as s, getContextManager as t, withCurrent as w };
+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 };

package/dist/index.browser.d.mts

@@ -551,6 +551,53 @@ type WrapAISDKOptions = {
      */
     nativeTelemetry?: boolean;
 };
+/**
+ * Opaque handle for a trace span. Pass as `parent` when creating child spans.
+ */
+type TraceSpan = {
+    readonly traceId: string;
+    readonly spanId: string;
+};
+type StartSpanArgs = {
+    /** Span name (e.g. "web_search", "finder_subagent"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall", "ai.generateText"). Helps classify the span. */
+    operationId?: string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
+type EndSpanArgs = {
+    /** Additional attributes to add when ending. */
+    attributes?: Record<string, string>;
+    /** Mark the span as failed. */
+    error?: Error | string;
+};
+type CreateSpanArgs = {
+    /** Span name (e.g. "SET theme=dark", "grep_search"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall"). Helps classify the span. */
+    operationId?: string;
+    /** Input data (will be JSON stringified if object). */
+    input?: unknown;
+    /** Output data (will be JSON stringified if object). */
+    output?: unknown;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Start time as epoch ms. Defaults to `Date.now() - durationMs`. */
+    startTime?: number;
+    /** Mark the span as failed. */
+    error?: Error | string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
 type EventPatch = {
     eventName?: string;
     userId?: string;
@@ -580,6 +627,46 @@ type RaindropAISDKClient = {
             properties?: Record<string, unknown>;
         }): Promise<void>;
     };
+    /**
+     * Manually create trace spans alongside (or instead of) auto-instrumented ones.
+     *
+     * Use `startSpan` / `endSpan` for spans with manual lifecycle control, or
+     * `createSpan` for one-shot spans where timing is already known.
+     *
+     * Spans share the same trace tree as auto-instrumented spans when you pass
+     * matching `eventId` values. Use `parent` to nest spans arbitrarily.
+     *
+     * @example
+     * ```typescript
+     * // One-shot span for a DSL command extracted from agent output
+     * raindrop.traces.createSpan({
+     *   name: "SET theme=dark",
+     *   eventId: "evt_123",
+     *   operationId: "ai.toolCall",
+     *   input: "SET theme=dark",
+     *   output: "OK",
+     *   durationMs: 12,
+     * });
+     *
+     * // Manual lifecycle for a subagent
+     * const agent = raindrop.traces.startSpan({
+     *   name: "finder_subagent",
+     *   eventId: "evt_456",
+     * });
+     * const tool = raindrop.traces.startSpan({
+     *   name: "grep_search",
+     *   eventId: "evt_456",
+     *   parent: agent,
+     * });
+     * raindrop.traces.endSpan(tool);
+     * raindrop.traces.endSpan(agent);
+     * ```
+     */
+    traces: {
+        startSpan(args: StartSpanArgs): TraceSpan;
+        endSpan(span: TraceSpan, extra?: EndSpanArgs): void;
+        createSpan(args: CreateSpanArgs): TraceSpan;
+    };
     users: {
         identify(users: IdentifyInput | IdentifyInput[]): Promise<void>;
     };
@@ -601,4 +688,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 EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, 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, 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 };

package/dist/index.browser.d.ts

@@ -551,6 +551,53 @@ type WrapAISDKOptions = {
      */
     nativeTelemetry?: boolean;
 };
+/**
+ * Opaque handle for a trace span. Pass as `parent` when creating child spans.
+ */
+type TraceSpan = {
+    readonly traceId: string;
+    readonly spanId: string;
+};
+type StartSpanArgs = {
+    /** Span name (e.g. "web_search", "finder_subagent"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall", "ai.generateText"). Helps classify the span. */
+    operationId?: string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
+type EndSpanArgs = {
+    /** Additional attributes to add when ending. */
+    attributes?: Record<string, string>;
+    /** Mark the span as failed. */
+    error?: Error | string;
+};
+type CreateSpanArgs = {
+    /** Span name (e.g. "SET theme=dark", "grep_search"). */
+    name: string;
+    /** Raindrop event ID this span belongs to. */
+    eventId: string;
+    /** Parent span for nesting. Omit for root spans. */
+    parent?: TraceSpan;
+    /** AI SDK operation ID (e.g. "ai.toolCall"). Helps classify the span. */
+    operationId?: string;
+    /** Input data (will be JSON stringified if object). */
+    input?: unknown;
+    /** Output data (will be JSON stringified if object). */
+    output?: unknown;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Start time as epoch ms. Defaults to `Date.now() - durationMs`. */
+    startTime?: number;
+    /** Mark the span as failed. */
+    error?: Error | string;
+    /** Arbitrary string attributes. */
+    attributes?: Record<string, string>;
+};
 type EventPatch = {
     eventName?: string;
     userId?: string;
@@ -580,6 +627,46 @@ type RaindropAISDKClient = {
             properties?: Record<string, unknown>;
         }): Promise<void>;
     };
+    /**
+     * Manually create trace spans alongside (or instead of) auto-instrumented ones.
+     *
+     * Use `startSpan` / `endSpan` for spans with manual lifecycle control, or
+     * `createSpan` for one-shot spans where timing is already known.
+     *
+     * Spans share the same trace tree as auto-instrumented spans when you pass
+     * matching `eventId` values. Use `parent` to nest spans arbitrarily.
+     *
+     * @example
+     * ```typescript
+     * // One-shot span for a DSL command extracted from agent output
+     * raindrop.traces.createSpan({
+     *   name: "SET theme=dark",
+     *   eventId: "evt_123",
+     *   operationId: "ai.toolCall",
+     *   input: "SET theme=dark",
+     *   output: "OK",
+     *   durationMs: 12,
+     * });
+     *
+     * // Manual lifecycle for a subagent
+     * const agent = raindrop.traces.startSpan({
+     *   name: "finder_subagent",
+     *   eventId: "evt_456",
+     * });
+     * const tool = raindrop.traces.startSpan({
+     *   name: "grep_search",
+     *   eventId: "evt_456",
+     *   parent: agent,
+     * });
+     * raindrop.traces.endSpan(tool);
+     * raindrop.traces.endSpan(agent);
+     * ```
+     */
+    traces: {
+        startSpan(args: StartSpanArgs): TraceSpan;
+        endSpan(span: TraceSpan, extra?: EndSpanArgs): void;
+        createSpan(args: CreateSpanArgs): TraceSpan;
+    };
     users: {
         identify(users: IdentifyInput | IdentifyInput[]): Promise<void>;
     };
@@ -601,4 +688,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 EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, 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, 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 };

package/dist/index.browser.js

@@ -160,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 } };
@@ -829,7 +832,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.21"};
+  version: "0.0.23"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -4075,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;
@@ -4143,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);

package/dist/index.browser.mjs

@@ -158,6 +158,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 } };
@@ -827,7 +830,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.21"};
+  version: "0.0.23"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -4073,6 +4076,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;
@@ -4141,6 +4152,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);

package/dist/index.node.d.mts

@@ -1,4 +1,4 @@
-export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, E as EventBuilder, g as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, h as RaindropAISDKContext, i as RaindropAISDKOptions, j as RaindropTelemetryIntegration, k as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, l as SelfDiagnosticsSignalDefinition, m as SelfDiagnosticsSignalDefinitions, W as WrapAISDKOptions, n as WrappedAI, o as WrappedAISDK, _ as _resetWarnedMissingUserId, p as createRaindropAISDK, q as currentSpan, r as eventMetadata, s as eventMetadataFromChatRequest, t as getContextManager, w as withCurrent } from './index-CPArLupC.mjs';
+export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, g as CreateSpanArgs, E as EndSpanArgs, h as EventBuilder, i as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, j as RaindropAISDKContext, k as RaindropAISDKOptions, l as RaindropTelemetryIntegration, m as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, n as SelfDiagnosticsSignalDefinition, o as SelfDiagnosticsSignalDefinitions, p as StartSpanArgs, T as TraceSpan, W as WrapAISDKOptions, q as WrappedAI, r as WrappedAISDK, _ as _resetWarnedMissingUserId, s as createRaindropAISDK, t as currentSpan, u as eventMetadata, v as eventMetadataFromChatRequest, w as getContextManager, x as withCurrent } from './index-sxjvhkYW.mjs';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.node.d.ts

@@ -1,4 +1,4 @@
-export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, E as EventBuilder, g as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, h as RaindropAISDKContext, i as RaindropAISDKOptions, j as RaindropTelemetryIntegration, k as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, l as SelfDiagnosticsSignalDefinition, m as SelfDiagnosticsSignalDefinitions, W as WrapAISDKOptions, n as WrappedAI, o as WrappedAISDK, _ as _resetWarnedMissingUserId, p as createRaindropAISDK, q as currentSpan, r as eventMetadata, s as eventMetadataFromChatRequest, t as getContextManager, w as withCurrent } from './index-CPArLupC.js';
+export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, g as CreateSpanArgs, E as EndSpanArgs, h as EventBuilder, i as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, j as RaindropAISDKContext, k as RaindropAISDKOptions, l as RaindropTelemetryIntegration, m as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, n as SelfDiagnosticsSignalDefinition, o as SelfDiagnosticsSignalDefinitions, p as StartSpanArgs, T as TraceSpan, W as WrapAISDKOptions, q as WrappedAI, r as WrappedAISDK, _ as _resetWarnedMissingUserId, s as createRaindropAISDK, t as currentSpan, u as eventMetadata, v as eventMetadataFromChatRequest, w as getContextManager, x as withCurrent } from './index-sxjvhkYW.js';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.node.js

@@ -164,6 +164,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 } };
@@ -834,7 +837,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = async_hooks.AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.21"};
+  version: "0.0.23"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -4080,6 +4083,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;
@@ -4148,6 +4159,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);

package/dist/index.node.mjs

@@ -1,4 +1,4 @@
-export { RaindropTelemetryIntegration, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent } from './chunk-BTNDCDA3.mjs';
+export { RaindropTelemetryIntegration, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent } from './chunk-VQZMQSBQ.mjs';
 import { AsyncLocalStorage } from 'async_hooks';
 
 globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;

package/dist/index.workers.d.mts

@@ -1,4 +1,4 @@
-export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, E as EventBuilder, g as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, h as RaindropAISDKContext, i as RaindropAISDKOptions, j as RaindropTelemetryIntegration, k as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, l as SelfDiagnosticsSignalDefinition, m as SelfDiagnosticsSignalDefinitions, W as WrapAISDKOptions, n as WrappedAI, o as WrappedAISDK, _ as _resetWarnedMissingUserId, p as createRaindropAISDK, q as currentSpan, r as eventMetadata, s as eventMetadataFromChatRequest, t as getContextManager, w as withCurrent } from './index-CPArLupC.mjs';
+export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, g as CreateSpanArgs, E as EndSpanArgs, h as EventBuilder, i as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, j as RaindropAISDKContext, k as RaindropAISDKOptions, l as RaindropTelemetryIntegration, m as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, n as SelfDiagnosticsSignalDefinition, o as SelfDiagnosticsSignalDefinitions, p as StartSpanArgs, T as TraceSpan, W as WrapAISDKOptions, q as WrappedAI, r as WrappedAISDK, _ as _resetWarnedMissingUserId, s as createRaindropAISDK, t as currentSpan, u as eventMetadata, v as eventMetadataFromChatRequest, w as getContextManager, x as withCurrent } from './index-sxjvhkYW.mjs';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.workers.d.ts

@@ -1,4 +1,4 @@
-export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, E as EventBuilder, g as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, h as RaindropAISDKContext, i as RaindropAISDKOptions, j as RaindropTelemetryIntegration, k as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, l as SelfDiagnosticsSignalDefinition, m as SelfDiagnosticsSignalDefinitions, W as WrapAISDKOptions, n as WrappedAI, o as WrappedAISDK, _ as _resetWarnedMissingUserId, p as createRaindropAISDK, q as currentSpan, r as eventMetadata, s as eventMetadataFromChatRequest, t as getContextManager, w as withCurrent } from './index-CPArLupC.js';
+export { A as AISDKChatRequestLike, a as AISDKChatRequestMessageLike, b as AISDKMessage, c as AgentCallMetadata, d as AgentWithMetadata, e as Attachment, B as BuildEventPatch, C as ContextManager, f as ContextSpan, g as CreateSpanArgs, E as EndSpanArgs, h as EventBuilder, i as EventMetadataOptions, I as IdentifyInput, R as RaindropAISDKClient, j as RaindropAISDKContext, k as RaindropAISDKOptions, l as RaindropTelemetryIntegration, m as RaindropTelemetryIntegrationOptions, S as SelfDiagnosticsOptions, n as SelfDiagnosticsSignalDefinition, o as SelfDiagnosticsSignalDefinitions, p as StartSpanArgs, T as TraceSpan, W as WrapAISDKOptions, q as WrappedAI, r as WrappedAISDK, _ as _resetWarnedMissingUserId, s as createRaindropAISDK, t as currentSpan, u as eventMetadata, v as eventMetadataFromChatRequest, w as getContextManager, x as withCurrent } from './index-sxjvhkYW.js';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.workers.js

@@ -164,6 +164,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 } };
@@ -834,7 +837,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = async_hooks.AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.21"};
+  version: "0.0.23"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -4080,6 +4083,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;
@@ -4148,6 +4159,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);

package/dist/index.workers.mjs

@@ -1,4 +1,4 @@
-export { RaindropTelemetryIntegration, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent } from './chunk-BTNDCDA3.mjs';
+export { RaindropTelemetryIntegration, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent } from './chunk-VQZMQSBQ.mjs';
 import { AsyncLocalStorage } from 'async_hooks';
 
 if (!globalThis.RAINDROP_ASYNC_LOCAL_STORAGE) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/ai-sdk",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "Standalone Vercel AI SDK integration for Raindrop (events + OTLP/HTTP JSON traces, no OTEL runtime)",
   "main": "dist/index.node.js",
   "module": "dist/index.node.mjs",