@raindrop-ai/ai-sdk 0.0.8 → 0.0.9

package/dist/{chunk-NFWQZOEK.mjs → chunk-R5GGKTXI.mjs}

@@ -84,7 +84,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.8"};
+  version: "0.0.9"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -118,13 +118,15 @@ var EventShipper = class {
     this.sticky = /* @__PURE__ */ new Map();
     this.timers = /* @__PURE__ */ new Map();
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when events are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
-    this.partialFlushMs = (_b = opts.partialFlushMs) != null ? _b : 1e3;
+    this.partialFlushMs = (_c = opts.partialFlushMs) != null ? _c : 1e3;
     this.context = getRuntimeContext();
   }
   isDebugEnabled() {
@@ -472,16 +474,18 @@ var TraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c, _d, _e;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when traces are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
     this.debugSpans = opts.debugSpans === true;
-    this.flushIntervalMs = (_b = opts.flushIntervalMs) != null ? _b : 1e3;
-    this.maxBatchSize = (_c = opts.maxBatchSize) != null ? _c : 50;
-    this.maxQueueSize = (_d = opts.maxQueueSize) != null ? _d : 5e3;
+    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
+    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
+    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
   }
   isDebugEnabled() {
     return this.debug;
@@ -1252,6 +1256,14 @@ function warnMissingUserIdOnce() {
 function _resetWarnedMissingUserId() {
   warnedMissingUserId = false;
 }
+function extractRaindropCallOptions(options) {
+  if (!isRecord(options)) return {};
+  const em = options["metadata"];
+  if (isRecord(em)) return extractRaindropMetadata(em);
+  const telemetry = extractExperimentalTelemetry(options);
+  if (telemetry == null ? void 0 : telemetry.metadata) return extractRaindropMetadata(telemetry.metadata);
+  return {};
+}
 function extractRaindropMetadata(metadata) {
   if (!metadata || typeof metadata !== "object") return {};
   const result = {};
@@ -1774,7 +1786,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
     const operation = `${className}.generate`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -1962,7 +1974,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
     const operation = `${className}.stream`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -2632,18 +2644,26 @@ function envDebugEnabled() {
 }
 function createRaindropAISDK(opts) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-  const eventsEnabled = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
-  const tracesEnabled = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const writeKey = opts.writeKey;
+  const eventsRequested = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
+  const tracesRequested = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const eventsEnabled = eventsRequested && !!writeKey;
+  const tracesEnabled = tracesRequested && !!writeKey;
   const envDebug = envDebugEnabled();
+  if (!writeKey && (eventsRequested || tracesRequested)) {
+    console.warn(
+      "[raindrop-ai/ai-sdk] writeKey not provided; telemetry shipping is disabled"
+    );
+  }
   const eventShipper = new EventShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: eventsEnabled,
     debug: ((_c = opts.events) == null ? void 0 : _c.debug) === true || envDebug,
     partialFlushMs: (_d = opts.events) == null ? void 0 : _d.partialFlushMs
   });
   const traceShipper = new TraceShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: tracesEnabled,
     debug: ((_e = opts.traces) == null ? void 0 : _e.debug) === true || envDebug,

package/dist/index.d.mts

@@ -127,6 +127,48 @@ type EventMetadataOptions = {
  * ```
  */
 declare function eventMetadata(options: EventMetadataOptions): Record<string, string>;
+type AgentCallMetadata = ReturnType<typeof eventMetadata>;
+type NormalizeUnknownAgentOptions<T> = T extends {
+    options: infer CallOptions;
+} ? unknown extends CallOptions ? Omit<T, "options"> & {
+    options?: never;
+} : T : T;
+/**
+ * Wraps an agent instance type so `generate()` and `stream()` accept optional
+ * Raindrop call metadata while preserving original return types.
+ */
+type AgentWithMetadata<A> = A extends {
+    generate: (...args: infer GenerateArgs) => infer GenerateReturn;
+    stream: (...args: infer StreamArgs) => infer StreamReturn;
+} ? Omit<A, "generate" | "stream"> & {
+    generate(...args: GenerateArgs extends [infer Options, ...infer Rest] ? [NormalizeUnknownAgentOptions<Options> & {
+        metadata?: AgentCallMetadata;
+    }, ...Rest] : GenerateArgs): GenerateReturn;
+    stream(...args: StreamArgs extends [infer Options, ...infer Rest] ? [NormalizeUnknownAgentOptions<Options> & {
+        metadata?: AgentCallMetadata;
+    }, ...Rest] : StreamArgs): StreamReturn;
+} : A;
+/**
+ * Structural wrapper type for AI SDK modules.
+ *
+ * - AI SDK v6: rewrites `ToolLoopAgent` constructor instance methods to accept
+ *   `metadata` on `generate/stream`.
+ * - AI SDK v4/v5: no `ToolLoopAgent` export, so the type is unchanged.
+ */
+type WrappedAISDK<T extends object> = T extends {
+    ToolLoopAgent: abstract new (...args: any[]) => any;
+} ? Omit<T, "ToolLoopAgent"> & {
+    ToolLoopAgent: new (...args: ConstructorParameters<T["ToolLoopAgent"]>) => AgentWithMetadata<InstanceType<T["ToolLoopAgent"]>>;
+} : T;
+/**
+ * Backward-compatible alias for wrapped AI SDK module types.
+ *
+ * This alias intentionally avoids referencing `import("ai")` to satisfy type
+ * resolution without requiring `ai` to be installed.
+ *
+ * Prefer `WrappedAISDK<typeof ai>` in app code when you have an `ai` import.
+ */
+type WrappedAI<T extends object = any> = WrappedAISDK<T>;
 type Attachment = {
     attachment_id?: string;
     name?: string;
@@ -139,7 +181,11 @@ type Attachment = {
     type: "text" | "image" | "iframe";
 });
 type RaindropAISDKOptions = {
-    writeKey: string;
+    /**
+     * API write key. If omitted, telemetry shipping is disabled but `wrap()` is
+     * still available for a consistent integration surface.
+     */
+    writeKey?: string;
     endpoint?: string;
     traces?: {
         enabled?: boolean;
@@ -217,7 +263,7 @@ type EventPatch = {
     timestamp?: string;
 };
 type RaindropAISDKClient = {
-    wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): T;
+    wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
     events: {
         patch(eventId: string, patch: EventPatch): Promise<void>;
         addAttachments(eventId: string, attachments: Attachment[]): Promise<void>;
@@ -249,4 +295,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKMessage, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type WrapAISDKOptions, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent };
+export { 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, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent };

package/dist/index.d.ts

@@ -127,6 +127,48 @@ type EventMetadataOptions = {
  * ```
  */
 declare function eventMetadata(options: EventMetadataOptions): Record<string, string>;
+type AgentCallMetadata = ReturnType<typeof eventMetadata>;
+type NormalizeUnknownAgentOptions<T> = T extends {
+    options: infer CallOptions;
+} ? unknown extends CallOptions ? Omit<T, "options"> & {
+    options?: never;
+} : T : T;
+/**
+ * Wraps an agent instance type so `generate()` and `stream()` accept optional
+ * Raindrop call metadata while preserving original return types.
+ */
+type AgentWithMetadata<A> = A extends {
+    generate: (...args: infer GenerateArgs) => infer GenerateReturn;
+    stream: (...args: infer StreamArgs) => infer StreamReturn;
+} ? Omit<A, "generate" | "stream"> & {
+    generate(...args: GenerateArgs extends [infer Options, ...infer Rest] ? [NormalizeUnknownAgentOptions<Options> & {
+        metadata?: AgentCallMetadata;
+    }, ...Rest] : GenerateArgs): GenerateReturn;
+    stream(...args: StreamArgs extends [infer Options, ...infer Rest] ? [NormalizeUnknownAgentOptions<Options> & {
+        metadata?: AgentCallMetadata;
+    }, ...Rest] : StreamArgs): StreamReturn;
+} : A;
+/**
+ * Structural wrapper type for AI SDK modules.
+ *
+ * - AI SDK v6: rewrites `ToolLoopAgent` constructor instance methods to accept
+ *   `metadata` on `generate/stream`.
+ * - AI SDK v4/v5: no `ToolLoopAgent` export, so the type is unchanged.
+ */
+type WrappedAISDK<T extends object> = T extends {
+    ToolLoopAgent: abstract new (...args: any[]) => any;
+} ? Omit<T, "ToolLoopAgent"> & {
+    ToolLoopAgent: new (...args: ConstructorParameters<T["ToolLoopAgent"]>) => AgentWithMetadata<InstanceType<T["ToolLoopAgent"]>>;
+} : T;
+/**
+ * Backward-compatible alias for wrapped AI SDK module types.
+ *
+ * This alias intentionally avoids referencing `import("ai")` to satisfy type
+ * resolution without requiring `ai` to be installed.
+ *
+ * Prefer `WrappedAISDK<typeof ai>` in app code when you have an `ai` import.
+ */
+type WrappedAI<T extends object = any> = WrappedAISDK<T>;
 type Attachment = {
     attachment_id?: string;
     name?: string;
@@ -139,7 +181,11 @@ type Attachment = {
     type: "text" | "image" | "iframe";
 });
 type RaindropAISDKOptions = {
-    writeKey: string;
+    /**
+     * API write key. If omitted, telemetry shipping is disabled but `wrap()` is
+     * still available for a consistent integration surface.
+     */
+    writeKey?: string;
     endpoint?: string;
     traces?: {
         enabled?: boolean;
@@ -217,7 +263,7 @@ type EventPatch = {
     timestamp?: string;
 };
 type RaindropAISDKClient = {
-    wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): T;
+    wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
     events: {
         patch(eventId: string, patch: EventPatch): Promise<void>;
         addAttachments(eventId: string, attachments: Attachment[]): Promise<void>;
@@ -249,4 +295,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKMessage, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type WrapAISDKOptions, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent };
+export { 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, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent };

package/dist/index.js

@@ -86,7 +86,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.8"};
+  version: "0.0.9"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -120,13 +120,15 @@ var EventShipper = class {
     this.sticky = /* @__PURE__ */ new Map();
     this.timers = /* @__PURE__ */ new Map();
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when events are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
-    this.partialFlushMs = (_b = opts.partialFlushMs) != null ? _b : 1e3;
+    this.partialFlushMs = (_c = opts.partialFlushMs) != null ? _c : 1e3;
     this.context = getRuntimeContext();
   }
   isDebugEnabled() {
@@ -474,16 +476,18 @@ var TraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c, _d, _e;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when traces are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
     this.debugSpans = opts.debugSpans === true;
-    this.flushIntervalMs = (_b = opts.flushIntervalMs) != null ? _b : 1e3;
-    this.maxBatchSize = (_c = opts.maxBatchSize) != null ? _c : 50;
-    this.maxQueueSize = (_d = opts.maxQueueSize) != null ? _d : 5e3;
+    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
+    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
+    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
   }
   isDebugEnabled() {
     return this.debug;
@@ -1254,6 +1258,14 @@ function warnMissingUserIdOnce() {
 function _resetWarnedMissingUserId() {
   warnedMissingUserId = false;
 }
+function extractRaindropCallOptions(options) {
+  if (!isRecord(options)) return {};
+  const em = options["metadata"];
+  if (isRecord(em)) return extractRaindropMetadata(em);
+  const telemetry = extractExperimentalTelemetry(options);
+  if (telemetry == null ? void 0 : telemetry.metadata) return extractRaindropMetadata(telemetry.metadata);
+  return {};
+}
 function extractRaindropMetadata(metadata) {
   if (!metadata || typeof metadata !== "object") return {};
   const result = {};
@@ -1776,7 +1788,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
     const operation = `${className}.generate`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -1964,7 +1976,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
     const operation = `${className}.stream`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -2634,18 +2646,26 @@ function envDebugEnabled() {
 }
 function createRaindropAISDK(opts) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-  const eventsEnabled = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
-  const tracesEnabled = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const writeKey = opts.writeKey;
+  const eventsRequested = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
+  const tracesRequested = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const eventsEnabled = eventsRequested && !!writeKey;
+  const tracesEnabled = tracesRequested && !!writeKey;
   const envDebug = envDebugEnabled();
+  if (!writeKey && (eventsRequested || tracesRequested)) {
+    console.warn(
+      "[raindrop-ai/ai-sdk] writeKey not provided; telemetry shipping is disabled"
+    );
+  }
   const eventShipper = new EventShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: eventsEnabled,
     debug: ((_c = opts.events) == null ? void 0 : _c.debug) === true || envDebug,
     partialFlushMs: (_d = opts.events) == null ? void 0 : _d.partialFlushMs
   });
   const traceShipper = new TraceShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: tracesEnabled,
     debug: ((_e = opts.traces) == null ? void 0 : _e.debug) === true || envDebug,

package/dist/index.mjs

@@ -1 +1 @@
-export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-NFWQZOEK.mjs';
+export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-R5GGKTXI.mjs';

package/dist/index.node.d.mts

@@ -1,4 +1,4 @@
-export { AISDKMessage, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.mjs';
+export { AISDKMessage, AgentCallMetadata, AgentWithMetadata, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, WrappedAI, WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.mjs';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.node.d.ts

@@ -1,4 +1,4 @@
-export { AISDKMessage, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.js';
+export { AISDKMessage, AgentCallMetadata, AgentWithMetadata, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, WrappedAI, WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.js';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.node.js

@@ -90,7 +90,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.8"};
+  version: "0.0.9"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -124,13 +124,15 @@ var EventShipper = class {
     this.sticky = /* @__PURE__ */ new Map();
     this.timers = /* @__PURE__ */ new Map();
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when events are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
-    this.partialFlushMs = (_b = opts.partialFlushMs) != null ? _b : 1e3;
+    this.partialFlushMs = (_c = opts.partialFlushMs) != null ? _c : 1e3;
     this.context = getRuntimeContext();
   }
   isDebugEnabled() {
@@ -478,16 +480,18 @@ var TraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c, _d, _e;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when traces are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
     this.debugSpans = opts.debugSpans === true;
-    this.flushIntervalMs = (_b = opts.flushIntervalMs) != null ? _b : 1e3;
-    this.maxBatchSize = (_c = opts.maxBatchSize) != null ? _c : 50;
-    this.maxQueueSize = (_d = opts.maxQueueSize) != null ? _d : 5e3;
+    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
+    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
+    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
   }
   isDebugEnabled() {
     return this.debug;
@@ -1258,6 +1262,14 @@ function warnMissingUserIdOnce() {
 function _resetWarnedMissingUserId() {
   warnedMissingUserId = false;
 }
+function extractRaindropCallOptions(options) {
+  if (!isRecord(options)) return {};
+  const em = options["metadata"];
+  if (isRecord(em)) return extractRaindropMetadata(em);
+  const telemetry = extractExperimentalTelemetry(options);
+  if (telemetry == null ? void 0 : telemetry.metadata) return extractRaindropMetadata(telemetry.metadata);
+  return {};
+}
 function extractRaindropMetadata(metadata) {
   if (!metadata || typeof metadata !== "object") return {};
   const result = {};
@@ -1780,7 +1792,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
     const operation = `${className}.generate`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -1968,7 +1980,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
     const operation = `${className}.stream`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -2638,18 +2650,26 @@ function envDebugEnabled() {
 }
 function createRaindropAISDK(opts) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-  const eventsEnabled = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
-  const tracesEnabled = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const writeKey = opts.writeKey;
+  const eventsRequested = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
+  const tracesRequested = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const eventsEnabled = eventsRequested && !!writeKey;
+  const tracesEnabled = tracesRequested && !!writeKey;
   const envDebug = envDebugEnabled();
+  if (!writeKey && (eventsRequested || tracesRequested)) {
+    console.warn(
+      "[raindrop-ai/ai-sdk] writeKey not provided; telemetry shipping is disabled"
+    );
+  }
   const eventShipper = new EventShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: eventsEnabled,
     debug: ((_c = opts.events) == null ? void 0 : _c.debug) === true || envDebug,
     partialFlushMs: (_d = opts.events) == null ? void 0 : _d.partialFlushMs
   });
   const traceShipper = new TraceShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: tracesEnabled,
     debug: ((_e = opts.traces) == null ? void 0 : _e.debug) === true || envDebug,

package/dist/index.node.mjs

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

package/dist/index.workers.d.mts

@@ -1,4 +1,4 @@
-export { AISDKMessage, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.mjs';
+export { AISDKMessage, AgentCallMetadata, AgentWithMetadata, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, WrappedAI, WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.mjs';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.workers.d.ts

@@ -1,4 +1,4 @@
-export { AISDKMessage, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.js';
+export { AISDKMessage, AgentCallMetadata, AgentWithMetadata, Attachment, BuildEventPatch, ContextManager, ContextSpan, EventBuilder, EventMetadataOptions, IdentifyInput, RaindropAISDKClient, RaindropAISDKContext, RaindropAISDKOptions, WrapAISDKOptions, WrappedAI, WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './index.js';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {

package/dist/index.workers.js

@@ -90,7 +90,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.8"};
+  version: "0.0.9"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -124,13 +124,15 @@ var EventShipper = class {
     this.sticky = /* @__PURE__ */ new Map();
     this.timers = /* @__PURE__ */ new Map();
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when events are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
-    this.partialFlushMs = (_b = opts.partialFlushMs) != null ? _b : 1e3;
+    this.partialFlushMs = (_c = opts.partialFlushMs) != null ? _c : 1e3;
     this.context = getRuntimeContext();
   }
   isDebugEnabled() {
@@ -478,16 +480,18 @@ var TraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d;
-    if (!opts.writeKey) throw new Error("[raindrop-ai/ai-sdk] writeKey is required");
-    this.writeKey = opts.writeKey;
-    this.baseUrl = (_a = formatEndpoint(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c, _d, _e;
+    if (opts.enabled && !opts.writeKey) {
+      throw new Error("[raindrop-ai/ai-sdk] writeKey is required when traces are enabled");
+    }
+    this.writeKey = (_a = opts.writeKey) != null ? _a : "";
+    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled;
     this.debug = opts.debug;
     this.debugSpans = opts.debugSpans === true;
-    this.flushIntervalMs = (_b = opts.flushIntervalMs) != null ? _b : 1e3;
-    this.maxBatchSize = (_c = opts.maxBatchSize) != null ? _c : 50;
-    this.maxQueueSize = (_d = opts.maxQueueSize) != null ? _d : 5e3;
+    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
+    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
+    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
   }
   isDebugEnabled() {
     return this.debug;
@@ -1258,6 +1262,14 @@ function warnMissingUserIdOnce() {
 function _resetWarnedMissingUserId() {
   warnedMissingUserId = false;
 }
+function extractRaindropCallOptions(options) {
+  if (!isRecord(options)) return {};
+  const em = options["metadata"];
+  if (isRecord(em)) return extractRaindropMetadata(em);
+  const telemetry = extractExperimentalTelemetry(options);
+  if (telemetry == null ? void 0 : telemetry.metadata) return extractRaindropMetadata(telemetry.metadata);
+  return {};
+}
 function extractRaindropMetadata(metadata) {
   if (!metadata || typeof metadata !== "object") return {};
   const result = {};
@@ -1780,7 +1792,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
     const operation = `${className}.generate`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -1968,7 +1980,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
     const operation = `${className}.stream`;
     const wrapTimeCtx = resolveContext(deps.options.context, { operation, args: mergedArgs });
     const telemetry = extractExperimentalTelemetry(mergedArgs);
-    const callTimeCtx = extractRaindropMetadata(telemetry == null ? void 0 : telemetry.metadata);
+    const callTimeCtx = extractRaindropCallOptions(mergedArgs);
     const mergedCtx = mergeContexts(wrapTimeCtx, callTimeCtx);
     if (!mergedCtx.userId) warnMissingUserIdOnce();
     const inherited = await getCurrentParentSpanContext();
@@ -2638,18 +2650,26 @@ function envDebugEnabled() {
 }
 function createRaindropAISDK(opts) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-  const eventsEnabled = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
-  const tracesEnabled = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const writeKey = opts.writeKey;
+  const eventsRequested = ((_a = opts.events) == null ? void 0 : _a.enabled) !== false;
+  const tracesRequested = ((_b = opts.traces) == null ? void 0 : _b.enabled) !== false;
+  const eventsEnabled = eventsRequested && !!writeKey;
+  const tracesEnabled = tracesRequested && !!writeKey;
   const envDebug = envDebugEnabled();
+  if (!writeKey && (eventsRequested || tracesRequested)) {
+    console.warn(
+      "[raindrop-ai/ai-sdk] writeKey not provided; telemetry shipping is disabled"
+    );
+  }
   const eventShipper = new EventShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: eventsEnabled,
     debug: ((_c = opts.events) == null ? void 0 : _c.debug) === true || envDebug,
     partialFlushMs: (_d = opts.events) == null ? void 0 : _d.partialFlushMs
   });
   const traceShipper = new TraceShipper({
-    writeKey: opts.writeKey,
+    writeKey,
     endpoint: opts.endpoint,
     enabled: tracesEnabled,
     debug: ((_e = opts.traces) == null ? void 0 : _e.debug) === true || envDebug,

package/dist/index.workers.mjs

@@ -1,4 +1,4 @@
-export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-NFWQZOEK.mjs';
+export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-R5GGKTXI.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.8",
+  "version": "0.0.9",
   "description": "Standalone Vercel AI SDK integration for Raindrop (events + OTLP/HTTP JSON traces, no OTEL runtime)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -45,6 +45,9 @@
     "tsx": "^4.20.3",
     "typescript": "^5.3.3"
   },
+  "peerDependencies": {
+    "ai": ">=4 <7"
+  },
   "tsup": {
     "entry": [
       "src/index.ts",