@raindrop-ai/ai-sdk 0.0.23 → 0.0.25

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Raindrop AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -55,6 +55,66 @@ await raindrop.users.identify({
 await raindrop.flush();
 ```
 
+## Manual Traces
+
+Create trace spans manually alongside, or instead of, auto-instrumented ones.
+
+Use `createSpan` when the timing is already known:
+
+```ts
+const eventId = "evt_123";
+
+raindrop.traces.createSpan({
+  name: "SET theme=dark",
+  eventId,
+  operationId: "ai.toolCall",
+  input: "SET theme=dark",
+  output: "OK",
+  durationMs: 12,
+});
+```
+
+Use `startSpan` / `endSpan` when you want to time an operation in real time:
+
+```ts
+const span = raindrop.traces.startSpan({
+  name: "database_query",
+  eventId: "evt_123",
+  operationId: "ai.toolCall",
+});
+
+try {
+  await db.query("SELECT ...");
+  raindrop.traces.endSpan(span);
+} catch (err) {
+  raindrop.traces.endSpan(span, { error: err instanceof Error ? err : String(err) });
+}
+```
+
+Pass a span as `parent` to build nested trace trees:
+
+```ts
+const eventId = "evt_456";
+
+const agentTurn = raindrop.traces.startSpan({
+  name: "agent_turn",
+  eventId,
+});
+
+raindrop.traces.createSpan({
+  name: "grep_search",
+  eventId,
+  parent: agentTurn,
+  operationId: "ai.toolCall",
+  input: { pattern: "execute" },
+  output: { matches: 12 },
+  durationMs: 120,
+});
+
+raindrop.traces.endSpan(agentTurn);
+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`).
@@ -192,135 +252,6 @@ 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-VQZMQSBQ.mjs → chunk-AUFHKHNR.mjs}

@@ -2494,7 +2494,7 @@ function setupOperation(params) {
       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.ai.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),
@@ -3059,7 +3059,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
@@ -3267,7 +3267,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
@@ -4007,7 +4007,7 @@ function extractNestedTokens(usage, key) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.23"};
+  version: "0.0.25"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;

package/dist/index.browser.js

@@ -832,7 +832,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.23"};
+  version: "0.0.25"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2528,7 +2528,7 @@ function setupOperation(params) {
       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.ai.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),
@@ -3093,7 +3093,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
@@ -3301,7 +3301,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),

package/dist/index.browser.mjs

@@ -830,7 +830,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.23"};
+  version: "0.0.25"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2526,7 +2526,7 @@ function setupOperation(params) {
       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.ai.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),
@@ -3091,7 +3091,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
@@ -3299,7 +3299,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),

package/dist/index.node.js

@@ -837,7 +837,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = async_hooks.AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.23"};
+  version: "0.0.25"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2533,7 +2533,7 @@ function setupOperation(params) {
       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.ai.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),
@@ -3098,7 +3098,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
@@ -3306,7 +3306,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),

package/dist/index.node.mjs

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

package/dist/index.workers.js

@@ -837,7 +837,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = async_hooks.AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.23"};
+  version: "0.0.25"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2533,7 +2533,7 @@ function setupOperation(params) {
       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.ai.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),
@@ -3098,7 +3098,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),
@@ -3306,7 +3306,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         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.ai.userId", ctx.userId),
         attrString("ai.telemetry.metadata.raindrop.convoId", ctx.convoId),
         ...attrsFromTelemetryMetadata(telemetry == null ? void 0 : telemetry.metadata),
         ...attrsFromHeaders(mergedArgs["headers"]),

package/dist/index.workers.mjs

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

package/package.json

@@ -1,10 +1,20 @@
 {
   "name": "@raindrop-ai/ai-sdk",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "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",
   "types": "dist/index.node.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raindrop-ai/raindrop-js.git",
+    "directory": "packages/ai-sdk"
+  },
+  "homepage": "https://github.com/raindrop-ai/raindrop-js/tree/main/packages/ai-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/raindrop-ai/raindrop-js/issues"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.node.d.ts",
@@ -26,6 +36,20 @@
   "files": [
     "dist/**"
   ],
+  "devDependencies": {
+    "@types/node": "^20.11.17",
+    "msw": "^2.12.7",
+    "tsup": "^8.4.0",
+    "tsx": "^4.20.3",
+    "typescript": "^5.3.3",
+    "@raindrop-ai/core": "0.0.1"
+  },
+  "peerDependencies": {
+    "ai": ">=4 <8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
@@ -40,19 +64,5 @@
     "test:v6": "pnpm build && cd tests/v6 && pnpm install --ignore-workspace --lockfile=false && pnpm test",
     "test:v7": "pnpm build && cd tests/v7 && pnpm install --ignore-workspace --lockfile=false && pnpm test",
     "test:install": "cd tests/v4 && pnpm install --ignore-workspace --lockfile=false && cd ../v5 && pnpm install --ignore-workspace --lockfile=false && cd ../v6 && pnpm install --ignore-workspace --lockfile=false && cd ../v7 && pnpm install --ignore-workspace --lockfile=false"
-  },
-  "devDependencies": {
-    "@raindrop-ai/core": "workspace:*",
-    "@types/node": "^20.11.17",
-    "msw": "^2.12.7",
-    "tsup": "^8.4.0",
-    "tsx": "^4.20.3",
-    "typescript": "^5.3.3"
-  },
-  "peerDependencies": {
-    "ai": ">=4 <8"
-  },
-  "publishConfig": {
-    "access": "public"
   }
-}
+}