@raindrop-ai/ai-sdk 0.0.41 → 0.1.1

package/dist/index.browser.d.ts

@@ -1,3 +1,14 @@
+type FeatureFlagValue = string | number | boolean;
+type FeatureFlags = string[] | Record<string, FeatureFlagValue>;
+/**
+ * Normalizes feature flags from the two accepted input forms into a
+ * canonical `Record<string, string>` ready for the wire payload.
+ *
+ * - Array form: `["a", "b"]` → `{"a": "true", "b": "true"}`
+ * - Object form: `{ a: "v2", b: true, c: 3 }` → `{"a": "v2", "b": "true", "c": "3"}`
+ */
+declare function normalizeFeatureFlags(input: FeatureFlags): Record<string, string>;
+
 type OtlpAnyValue = {
     stringValue?: string;
     intValue?: string;
@@ -53,6 +64,7 @@ type Patch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment$1[];
     isPending?: boolean;
     timestamp?: string;
@@ -153,6 +165,7 @@ declare class EventShipper$1 {
         output?: string;
         model?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
         userId?: string;
     }): Promise<void>;
     flush(): Promise<void>;
@@ -490,6 +503,37 @@ declare class TraceShipper extends TraceShipper$1 {
     constructor(opts: ConstructorParameters<typeof TraceShipper$1>[0]);
 }
 
+/**
+ * Raindrop telemetry integration for AI SDK v7+
+ *
+ * Implements the AI SDK's `Telemetry` interface (formerly `TelemetryIntegration`
+ * before v7 beta.111) to capture traces and events natively, replacing the
+ * Proxy-based wrapping used for v4-v6.
+ *
+ * Modeled after the upstream OpenTelemetry integration but uses Raindrop's
+ * TraceShipper (OTLP/HTTP) + EventShipper instead of the OTel Tracer API.
+ *
+ * Compatibility: this class targets the latest published v7 build but also
+ * exposes the older v7 callback names as aliases so it works on every v7
+ * beta/canary released to date:
+ *   - `onToolCallStart`/`onToolCallFinish` (< beta.111) alongside
+ *     `onToolExecutionStart`/`onToolExecutionEnd` (>= beta.111).
+ *   - Current `onToolExecutionEnd` events use the `toolOutput` discriminated
+ *     union; older builds used top-level `success`/`output`/`error` fields.
+ *   - `onFinish`/`onEmbedFinish` (< canary.159) alongside `onEnd`/`onEmbedEnd`
+ *     (>= canary.159, vercel/ai renamed the operation finalizers).
+ *   - `onAbort` (added as a telemetry-integration callback on the v7 canary
+ *     line, post-beta.116) finalizes open spans + the pending event when a
+ *     `streamText` call is cancelled via its `AbortSignal`. Builds that don't
+ *     dispatch it to integrations simply never call it, so it's a no-op there.
+ *
+ * Step-end note: we intentionally implement only `onStepFinish` (not the newer
+ * `onStepEnd`). The latest canary dispatcher fans every step-end event out to
+ * BOTH `onStepEnd` and the deprecated `onStepFinish` on each integration, so
+ * implementing both names would double-close the step span. `onStepFinish`
+ * alone is dispatched on every published v7 beta/canary to date.
+ */
+
 type Listener<T> = (event: T) => PromiseLike<void> | void;
 type ToolExecutionEndEvent = {
     callId: string;
@@ -563,6 +607,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: FeatureFlags;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -839,6 +884,8 @@ type EventMetadataOptions = {
     eventName?: string;
     /** Additional properties to merge with wrap-time properties */
     properties?: Record<string, unknown>;
+    /** Feature flags to attach to this event (merged with wrap-time flags; call-time wins) */
+    featureFlags?: FeatureFlags;
 };
 /**
  * Creates metadata for use with the AI SDK's `experimental_telemetry.metadata` option.
@@ -1042,6 +1089,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1051,6 +1099,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1215,6 +1264,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1247,10 +1297,12 @@ type RaindropAISDKClient = {
         patch(eventId: string, patch: EventPatch): Promise<void>;
         addAttachments(eventId: string, attachments: Attachment[]): Promise<void>;
         setProperties(eventId: string, properties: Record<string, unknown>): Promise<void>;
+        setFeatureFlags(eventId: string, featureFlags: FeatureFlags): Promise<void>;
         finish(eventId: string, patch: {
             output?: string;
             model?: string;
             properties?: Record<string, unknown>;
+            featureFlags?: Record<string, string>;
         }): Promise<void>;
     };
     /**
@@ -1361,4 +1413,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, TRUNCATION_MARKER, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, TRUNCATION_MARKER, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };

package/dist/index.browser.js

@@ -1,6 +1,14 @@
 'use strict';
 
-// ../core/dist/chunk-WKRW55KX.js
+// ../core/dist/chunk-Y5LUB7OE.js
+function normalizeFeatureFlags(input) {
+  if (Array.isArray(input)) {
+    return Object.fromEntries(input.map((name) => [name, "true"]));
+  }
+  return Object.fromEntries(
+    Object.entries(input).map(([k, v]) => [k, String(v)])
+  );
+}
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -435,13 +443,16 @@ function projectIdHeaders(projectId) {
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f;
   const out = { ...target, ...source };
   if (target.properties || source.properties) {
     out.properties = { ...(_a = target.properties) != null ? _a : {}, ...(_b = source.properties) != null ? _b : {} };
   }
+  if (target.featureFlags || source.featureFlags) {
+    out.featureFlags = { ...(_c = target.featureFlags) != null ? _c : {}, ...(_d = source.featureFlags) != null ? _d : {} };
+  }
   if (target.attachments || source.attachments) {
-    out.attachments = [...(_c = target.attachments) != null ? _c : [], ...(_d = source.attachments) != null ? _d : []];
+    out.attachments = [...(_e = target.attachments) != null ? _e : [], ...(_f = source.attachments) != null ? _f : []];
   }
   return out;
 }
@@ -711,6 +722,7 @@ var EventShipper = class {
         ...wizardSession ? { "raindrop.wizardSession": wizardSession } : {},
         $context: this.context
       },
+      ...accumulated.featureFlags && Object.keys(accumulated.featureFlags).length > 0 ? { feature_flags: accumulated.featureFlags } : {},
       attachments: accumulated.attachments,
       is_pending: isPending
     };
@@ -1299,7 +1311,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.41"};
+  version: "0.1.1"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2721,6 +2733,20 @@ var RaindropTelemetryIntegration = class {
     } else if (properties && typeof properties === "object") {
       result.properties = properties;
     }
+    const featureFlags = metadata["raindrop.featureFlags"];
+    if (typeof featureFlags === "string") {
+      try {
+        const parsed = JSON.parse(featureFlags);
+        if (parsed && typeof parsed === "object") {
+          result.featureFlags = normalizeFeatureFlags(parsed);
+        }
+      } catch (e) {
+      }
+    } else if (featureFlags && typeof featureFlags === "object") {
+      result.featureFlags = normalizeFeatureFlags(
+        featureFlags
+      );
+    }
     return result;
   }
   /**
@@ -2935,7 +2961,7 @@ var RaindropTelemetryIntegration = class {
    * same event ID into a separate canonical row.
    */
   finalizeGenerateEvent(state, output, model, keepPending = false) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const suppressSubagentEvent = state.subagentName !== void 0 && state.subagentToolCallSpan !== void 0;
     if (!this.sendEvents || suppressSubagentEvent) return;
     const callMeta = this.extractRaindropMetadata(state.metadata);
@@ -2948,7 +2974,11 @@ var RaindropTelemetryIntegration = class {
       ...(_f = this.defaultContext) == null ? void 0 : _f.properties,
       ...callMeta.properties
     };
-    const convoId = (_h = callMeta.convoId) != null ? _h : (_g = this.defaultContext) == null ? void 0 : _g.convoId;
+    const featureFlags = {
+      ...((_g = this.defaultContext) == null ? void 0 : _g.featureFlags) ? normalizeFeatureFlags(this.defaultContext.featureFlags) : {},
+      ...callMeta.featureFlags
+    };
+    const convoId = (_i = callMeta.convoId) != null ? _i : (_h = this.defaultContext) == null ? void 0 : _h.convoId;
     void this.eventShipper.patch(state.eventId, {
       eventName,
       userId,
@@ -2957,6 +2987,7 @@ var RaindropTelemetryIntegration = class {
       output: cappedOutput,
       model,
       properties: Object.keys(properties).length > 0 ? properties : void 0,
+      featureFlags: Object.keys(featureFlags).length > 0 ? featureFlags : void 0,
       isPending: keepPending
     }).catch((err) => {
       if (this.debug) {
@@ -3280,6 +3311,20 @@ function extractRaindropMetadata(metadata) {
   } else if (properties && typeof properties === "object") {
     result.properties = properties;
   }
+  const featureFlags = metadata["raindrop.featureFlags"];
+  if (typeof featureFlags === "string") {
+    try {
+      const parsed = JSON.parse(featureFlags);
+      if (parsed && typeof parsed === "object") {
+        result.featureFlags = normalizeFeatureFlags(parsed);
+      }
+    } catch (e) {
+    }
+  } else if (featureFlags && typeof featureFlags === "object") {
+    result.featureFlags = normalizeFeatureFlags(
+      featureFlags
+    );
+  }
   return result;
 }
 function mergeContexts(wrapTime, callTime) {
@@ -3294,6 +3339,10 @@ function mergeContexts(wrapTime, callTime) {
       ...callTime.properties
     };
   }
+  if (callTime.featureFlags) {
+    const wrapTimeFlags = wrapTime.featureFlags ? normalizeFeatureFlags(wrapTime.featureFlags) : {};
+    result.featureFlags = { ...wrapTimeFlags, ...callTime.featureFlags };
+  }
   return result;
 }
 function detectAISDKVersion(aiSDK) {
@@ -3606,6 +3655,7 @@ function createFinalize(params) {
       output: defaultOutput,
       model,
       properties: setup.ctx.properties,
+      featureFlags: setup.ctx.featureFlags ? normalizeFeatureFlags(setup.ctx.featureFlags) : void 0,
       attachments: mergeAttachments(setup.ctx.attachments, inputAttachments, outputAttachments)
     };
     const built = await maybeBuildEvent(options.buildEvent, allMessages);
@@ -3659,6 +3709,7 @@ function createFinalize(params) {
         output,
         model: finalModel,
         properties: patch.properties,
+        featureFlags: patch.featureFlags,
         attachments: patch.attachments,
         isPending: keepEventPending
       }).catch((err) => {
@@ -3890,7 +3941,8 @@ function wrapAISDK(aiSDK, deps) {
         eventId: wrapTimeCtx.eventId,
         eventName: wrapTimeCtx.eventName,
         convoId: wrapTimeCtx.convoId,
-        properties: wrapTimeCtx.properties
+        properties: wrapTimeCtx.properties,
+        featureFlags: wrapTimeCtx.featureFlags ? normalizeFeatureFlags(wrapTimeCtx.featureFlags) : void 0
       }
     });
     const registerFn = resolveRegisterTelemetry(aiSDK);
@@ -4166,6 +4218,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         output: outputText,
         model,
         properties: ctx.properties,
+        featureFlags: ctx.featureFlags ? normalizeFeatureFlags(ctx.featureFlags) : void 0,
         attachments: mergeAttachments(ctx.attachments, inputAttachments, outputAttachments)
       };
       const built = await maybeBuildEvent(deps.options.buildEvent, allMessages);
@@ -4233,6 +4286,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -4374,6 +4428,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         output: outputText,
         model,
         properties: ctx.properties,
+        featureFlags: ctx.featureFlags ? normalizeFeatureFlags(ctx.featureFlags) : void 0,
         attachments: mergeAttachments(ctx.attachments, inputAttachments, outputAttachments)
       };
       const built = await maybeBuildEvent(deps.options.buildEvent, allMessages);
@@ -4441,6 +4496,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -5038,7 +5094,7 @@ async function maybeBuildEvent(buildEvent, messages) {
   }
 }
 function mergeBuildEventPatch(defaults, override) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   if (!override) return defaults;
   return {
     eventName: (_a = override.eventName) != null ? _a : defaults.eventName,
@@ -5046,7 +5102,8 @@ function mergeBuildEventPatch(defaults, override) {
     output: (_c = override.output) != null ? _c : defaults.output,
     model: (_d = override.model) != null ? _d : defaults.model,
     properties: override.properties !== void 0 ? { ...(_e = defaults.properties) != null ? _e : {}, ...(_f = override.properties) != null ? _f : {} } : defaults.properties,
-    attachments: override.attachments !== void 0 ? [...(_g = defaults.attachments) != null ? _g : [], ...(_h = override.attachments) != null ? _h : []] : defaults.attachments
+    featureFlags: override.featureFlags !== void 0 ? { ...(_g = defaults.featureFlags) != null ? _g : {}, ...(_h = override.featureFlags) != null ? _h : {} } : defaults.featureFlags,
+    attachments: override.attachments !== void 0 ? [...(_i = defaults.attachments) != null ? _i : [], ...(_j = override.attachments) != null ? _j : []] : defaults.attachments
   };
 }
 function mergeAttachments(...groups) {
@@ -5077,6 +5134,8 @@ function eventMetadata(options) {
   if (options.convoId) result["raindrop.convoId"] = options.convoId;
   if (options.eventName) result["raindrop.eventName"] = options.eventName;
   if (options.properties) result["raindrop.properties"] = JSON.stringify(options.properties);
+  if (options.featureFlags)
+    result["raindrop.featureFlags"] = JSON.stringify(normalizeFeatureFlags(options.featureFlags));
   return result;
 }
 function deriveChatTurnMessageId(request) {
@@ -5181,7 +5240,8 @@ function createRaindropAISDK(opts) {
         "eventId",
         "eventName",
         "convoId",
-        "properties"
+        "properties",
+        "featureFlags"
       ];
       let context;
       let subagentWrapping;
@@ -5213,6 +5273,9 @@ function createRaindropAISDK(opts) {
       async setProperties(eventId, properties) {
         await eventShipper.patch(eventId, { properties });
       },
+      async setFeatureFlags(eventId, featureFlags) {
+        await eventShipper.patch(eventId, { featureFlags: normalizeFeatureFlags(featureFlags) });
+      },
       async finish(eventId, patch) {
         await eventShipper.finish(eventId, patch);
       }
@@ -5334,6 +5397,7 @@ exports.eventMetadataFromChatRequest = eventMetadataFromChatRequest;
 exports.getContextManager = getContextManager;
 exports.getCurrentParentToolContext = getCurrentParentToolContext;
 exports.getCurrentRaindropCallMetadata = getCurrentRaindropCallMetadata;
+exports.normalizeFeatureFlags = normalizeFeatureFlags;
 exports.raindrop = raindrop;
 exports.readRaindropCallMetadataFromArgs = readRaindropCallMetadataFromArgs;
 exports.redactJsonAttributeValue = redactJsonAttributeValue;

package/dist/index.browser.mjs

@@ -1,4 +1,12 @@
-// ../core/dist/chunk-WKRW55KX.js
+// ../core/dist/chunk-Y5LUB7OE.js
+function normalizeFeatureFlags(input) {
+  if (Array.isArray(input)) {
+    return Object.fromEntries(input.map((name) => [name, "true"]));
+  }
+  return Object.fromEntries(
+    Object.entries(input).map(([k, v]) => [k, String(v)])
+  );
+}
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -433,13 +441,16 @@ function projectIdHeaders(projectId) {
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f;
   const out = { ...target, ...source };
   if (target.properties || source.properties) {
     out.properties = { ...(_a = target.properties) != null ? _a : {}, ...(_b = source.properties) != null ? _b : {} };
   }
+  if (target.featureFlags || source.featureFlags) {
+    out.featureFlags = { ...(_c = target.featureFlags) != null ? _c : {}, ...(_d = source.featureFlags) != null ? _d : {} };
+  }
   if (target.attachments || source.attachments) {
-    out.attachments = [...(_c = target.attachments) != null ? _c : [], ...(_d = source.attachments) != null ? _d : []];
+    out.attachments = [...(_e = target.attachments) != null ? _e : [], ...(_f = source.attachments) != null ? _f : []];
   }
   return out;
 }
@@ -709,6 +720,7 @@ var EventShipper = class {
         ...wizardSession ? { "raindrop.wizardSession": wizardSession } : {},
         $context: this.context
       },
+      ...accumulated.featureFlags && Object.keys(accumulated.featureFlags).length > 0 ? { feature_flags: accumulated.featureFlags } : {},
       attachments: accumulated.attachments,
       is_pending: isPending
     };
@@ -1297,7 +1309,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.41"};
+  version: "0.1.1"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2719,6 +2731,20 @@ var RaindropTelemetryIntegration = class {
     } else if (properties && typeof properties === "object") {
       result.properties = properties;
     }
+    const featureFlags = metadata["raindrop.featureFlags"];
+    if (typeof featureFlags === "string") {
+      try {
+        const parsed = JSON.parse(featureFlags);
+        if (parsed && typeof parsed === "object") {
+          result.featureFlags = normalizeFeatureFlags(parsed);
+        }
+      } catch (e) {
+      }
+    } else if (featureFlags && typeof featureFlags === "object") {
+      result.featureFlags = normalizeFeatureFlags(
+        featureFlags
+      );
+    }
     return result;
   }
   /**
@@ -2933,7 +2959,7 @@ var RaindropTelemetryIntegration = class {
    * same event ID into a separate canonical row.
    */
   finalizeGenerateEvent(state, output, model, keepPending = false) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const suppressSubagentEvent = state.subagentName !== void 0 && state.subagentToolCallSpan !== void 0;
     if (!this.sendEvents || suppressSubagentEvent) return;
     const callMeta = this.extractRaindropMetadata(state.metadata);
@@ -2946,7 +2972,11 @@ var RaindropTelemetryIntegration = class {
       ...(_f = this.defaultContext) == null ? void 0 : _f.properties,
       ...callMeta.properties
     };
-    const convoId = (_h = callMeta.convoId) != null ? _h : (_g = this.defaultContext) == null ? void 0 : _g.convoId;
+    const featureFlags = {
+      ...((_g = this.defaultContext) == null ? void 0 : _g.featureFlags) ? normalizeFeatureFlags(this.defaultContext.featureFlags) : {},
+      ...callMeta.featureFlags
+    };
+    const convoId = (_i = callMeta.convoId) != null ? _i : (_h = this.defaultContext) == null ? void 0 : _h.convoId;
     void this.eventShipper.patch(state.eventId, {
       eventName,
       userId,
@@ -2955,6 +2985,7 @@ var RaindropTelemetryIntegration = class {
       output: cappedOutput,
       model,
       properties: Object.keys(properties).length > 0 ? properties : void 0,
+      featureFlags: Object.keys(featureFlags).length > 0 ? featureFlags : void 0,
       isPending: keepPending
     }).catch((err) => {
       if (this.debug) {
@@ -3278,6 +3309,20 @@ function extractRaindropMetadata(metadata) {
   } else if (properties && typeof properties === "object") {
     result.properties = properties;
   }
+  const featureFlags = metadata["raindrop.featureFlags"];
+  if (typeof featureFlags === "string") {
+    try {
+      const parsed = JSON.parse(featureFlags);
+      if (parsed && typeof parsed === "object") {
+        result.featureFlags = normalizeFeatureFlags(parsed);
+      }
+    } catch (e) {
+    }
+  } else if (featureFlags && typeof featureFlags === "object") {
+    result.featureFlags = normalizeFeatureFlags(
+      featureFlags
+    );
+  }
   return result;
 }
 function mergeContexts(wrapTime, callTime) {
@@ -3292,6 +3337,10 @@ function mergeContexts(wrapTime, callTime) {
       ...callTime.properties
     };
   }
+  if (callTime.featureFlags) {
+    const wrapTimeFlags = wrapTime.featureFlags ? normalizeFeatureFlags(wrapTime.featureFlags) : {};
+    result.featureFlags = { ...wrapTimeFlags, ...callTime.featureFlags };
+  }
   return result;
 }
 function detectAISDKVersion(aiSDK) {
@@ -3604,6 +3653,7 @@ function createFinalize(params) {
       output: defaultOutput,
       model,
       properties: setup.ctx.properties,
+      featureFlags: setup.ctx.featureFlags ? normalizeFeatureFlags(setup.ctx.featureFlags) : void 0,
       attachments: mergeAttachments(setup.ctx.attachments, inputAttachments, outputAttachments)
     };
     const built = await maybeBuildEvent(options.buildEvent, allMessages);
@@ -3657,6 +3707,7 @@ function createFinalize(params) {
         output,
         model: finalModel,
         properties: patch.properties,
+        featureFlags: patch.featureFlags,
         attachments: patch.attachments,
         isPending: keepEventPending
       }).catch((err) => {
@@ -3888,7 +3939,8 @@ function wrapAISDK(aiSDK, deps) {
         eventId: wrapTimeCtx.eventId,
         eventName: wrapTimeCtx.eventName,
         convoId: wrapTimeCtx.convoId,
-        properties: wrapTimeCtx.properties
+        properties: wrapTimeCtx.properties,
+        featureFlags: wrapTimeCtx.featureFlags ? normalizeFeatureFlags(wrapTimeCtx.featureFlags) : void 0
       }
     });
     const registerFn = resolveRegisterTelemetry(aiSDK);
@@ -4164,6 +4216,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         output: outputText,
         model,
         properties: ctx.properties,
+        featureFlags: ctx.featureFlags ? normalizeFeatureFlags(ctx.featureFlags) : void 0,
         attachments: mergeAttachments(ctx.attachments, inputAttachments, outputAttachments)
       };
       const built = await maybeBuildEvent(deps.options.buildEvent, allMessages);
@@ -4231,6 +4284,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -4372,6 +4426,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         output: outputText,
         model,
         properties: ctx.properties,
+        featureFlags: ctx.featureFlags ? normalizeFeatureFlags(ctx.featureFlags) : void 0,
         attachments: mergeAttachments(ctx.attachments, inputAttachments, outputAttachments)
       };
       const built = await maybeBuildEvent(deps.options.buildEvent, allMessages);
@@ -4439,6 +4494,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -5036,7 +5092,7 @@ async function maybeBuildEvent(buildEvent, messages) {
   }
 }
 function mergeBuildEventPatch(defaults, override) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   if (!override) return defaults;
   return {
     eventName: (_a = override.eventName) != null ? _a : defaults.eventName,
@@ -5044,7 +5100,8 @@ function mergeBuildEventPatch(defaults, override) {
     output: (_c = override.output) != null ? _c : defaults.output,
     model: (_d = override.model) != null ? _d : defaults.model,
     properties: override.properties !== void 0 ? { ...(_e = defaults.properties) != null ? _e : {}, ...(_f = override.properties) != null ? _f : {} } : defaults.properties,
-    attachments: override.attachments !== void 0 ? [...(_g = defaults.attachments) != null ? _g : [], ...(_h = override.attachments) != null ? _h : []] : defaults.attachments
+    featureFlags: override.featureFlags !== void 0 ? { ...(_g = defaults.featureFlags) != null ? _g : {}, ...(_h = override.featureFlags) != null ? _h : {} } : defaults.featureFlags,
+    attachments: override.attachments !== void 0 ? [...(_i = defaults.attachments) != null ? _i : [], ...(_j = override.attachments) != null ? _j : []] : defaults.attachments
   };
 }
 function mergeAttachments(...groups) {
@@ -5075,6 +5132,8 @@ function eventMetadata(options) {
   if (options.convoId) result["raindrop.convoId"] = options.convoId;
   if (options.eventName) result["raindrop.eventName"] = options.eventName;
   if (options.properties) result["raindrop.properties"] = JSON.stringify(options.properties);
+  if (options.featureFlags)
+    result["raindrop.featureFlags"] = JSON.stringify(normalizeFeatureFlags(options.featureFlags));
   return result;
 }
 function deriveChatTurnMessageId(request) {
@@ -5179,7 +5238,8 @@ function createRaindropAISDK(opts) {
         "eventId",
         "eventName",
         "convoId",
-        "properties"
+        "properties",
+        "featureFlags"
       ];
       let context;
       let subagentWrapping;
@@ -5211,6 +5271,9 @@ function createRaindropAISDK(opts) {
       async setProperties(eventId, properties) {
         await eventShipper.patch(eventId, { properties });
       },
+      async setFeatureFlags(eventId, featureFlags) {
+        await eventShipper.patch(eventId, { featureFlags: normalizeFeatureFlags(featureFlags) });
+      },
       async finish(eventId, patch) {
         await eventShipper.finish(eventId, patch);
       }
@@ -5311,4 +5374,4 @@ function raindrop(options = {}) {
   return client.createTelemetryIntegration({ context, subagentWrapping });
 }
 
-export { DEFAULT_MAX_TEXT_FIELD_CHARS2 as DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, REDACTED_PLACEHOLDER, RaindropTelemetryIntegration, TRUNCATION_MARKER2 as TRUNCATION_MARKER, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText2 as capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };
+export { DEFAULT_MAX_TEXT_FIELD_CHARS2 as DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, REDACTED_PLACEHOLDER, RaindropTelemetryIntegration, TRUNCATION_MARKER2 as TRUNCATION_MARKER, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText2 as capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };

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, g as CreateSpanArgs, D as DEFAULT_MAX_TEXT_FIELD_CHARS, h as DEFAULT_REDACT_ATTRIBUTE_KEYS, i as DEFAULT_SECRET_KEY_NAMES, E as EndSpanArgs, j as EventBuilder, k as EventMetadataOptions, I as IdentifyInput, O as OtlpAnyValue, l as OtlpSpan, P as ParentToolContext, R as REDACTED_PLACEHOLDER, m as RaindropAISDKClient, n as RaindropAISDKContext, o as RaindropAISDKOptions, p as RaindropCallMetadata, q as RaindropTelemetryIntegration, r as RaindropTelemetryIntegrationOptions, s as RaindropTelemetryOptions, S as SelfDiagnosticsOptions, t as SelfDiagnosticsSignalDefinition, u as SelfDiagnosticsSignalDefinitions, v as SelfDiagnosticsTool, w as SelfDiagnosticsToolInput, x as SelfDiagnosticsToolOptions, y as SelfDiagnosticsToolResult, z as StartSpanArgs, T as TRUNCATION_MARKER, F as TraceSpan, G as TransformSpanHook, W as WrapAISDKOptions, H as WrappedAI, J as WrappedAISDK, _ as _resetParentToolContextStorage, K as _resetRaindropCallMetadataStorage, L as _resetWarnedMissingUserId, M as boundedStringify, N as capText, Q as clearParentToolContext, U as createRaindropAISDK, V as currentSpan, X as defaultTransformSpan, Y as enterParentToolContext, Z as eventMetadata, $ as eventMetadataFromChatRequest, a0 as getContextManager, a1 as getCurrentParentToolContext, a2 as getCurrentRaindropCallMetadata, a3 as raindrop, a4 as readRaindropCallMetadataFromArgs, a5 as redactJsonAttributeValue, a6 as redactSecretsInObject, a7 as runWithParentToolContext, a8 as runWithRaindropCallMetadata, a9 as withCurrent } from './index-BCojLiWV.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, D as DEFAULT_MAX_TEXT_FIELD_CHARS, h as DEFAULT_REDACT_ATTRIBUTE_KEYS, i as DEFAULT_SECRET_KEY_NAMES, E as EndSpanArgs, j as EventBuilder, k as EventMetadataOptions, F as FeatureFlagValue, l as FeatureFlags, I as IdentifyInput, O as OtlpAnyValue, m as OtlpSpan, P as ParentToolContext, R as REDACTED_PLACEHOLDER, n as RaindropAISDKClient, o as RaindropAISDKContext, p as RaindropAISDKOptions, q as RaindropCallMetadata, r as RaindropTelemetryIntegration, s as RaindropTelemetryIntegrationOptions, t as RaindropTelemetryOptions, S as SelfDiagnosticsOptions, u as SelfDiagnosticsSignalDefinition, v as SelfDiagnosticsSignalDefinitions, w as SelfDiagnosticsTool, x as SelfDiagnosticsToolInput, y as SelfDiagnosticsToolOptions, z as SelfDiagnosticsToolResult, G as StartSpanArgs, T as TRUNCATION_MARKER, H as TraceSpan, J as TransformSpanHook, W as WrapAISDKOptions, K as WrappedAI, L as WrappedAISDK, _ as _resetParentToolContextStorage, M as _resetRaindropCallMetadataStorage, N as _resetWarnedMissingUserId, Q as boundedStringify, U as capText, V as clearParentToolContext, X as createRaindropAISDK, Y as currentSpan, Z as defaultTransformSpan, $ as enterParentToolContext, a0 as eventMetadata, a1 as eventMetadataFromChatRequest, a2 as getContextManager, a3 as getCurrentParentToolContext, a4 as getCurrentRaindropCallMetadata, a5 as normalizeFeatureFlags, a6 as raindrop, a7 as readRaindropCallMetadataFromArgs, a8 as redactJsonAttributeValue, a9 as redactSecretsInObject, aa as runWithParentToolContext, ab as runWithRaindropCallMetadata, ac as withCurrent } from './index-BQwgg9kQ.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, g as CreateSpanArgs, D as DEFAULT_MAX_TEXT_FIELD_CHARS, h as DEFAULT_REDACT_ATTRIBUTE_KEYS, i as DEFAULT_SECRET_KEY_NAMES, E as EndSpanArgs, j as EventBuilder, k as EventMetadataOptions, I as IdentifyInput, O as OtlpAnyValue, l as OtlpSpan, P as ParentToolContext, R as REDACTED_PLACEHOLDER, m as RaindropAISDKClient, n as RaindropAISDKContext, o as RaindropAISDKOptions, p as RaindropCallMetadata, q as RaindropTelemetryIntegration, r as RaindropTelemetryIntegrationOptions, s as RaindropTelemetryOptions, S as SelfDiagnosticsOptions, t as SelfDiagnosticsSignalDefinition, u as SelfDiagnosticsSignalDefinitions, v as SelfDiagnosticsTool, w as SelfDiagnosticsToolInput, x as SelfDiagnosticsToolOptions, y as SelfDiagnosticsToolResult, z as StartSpanArgs, T as TRUNCATION_MARKER, F as TraceSpan, G as TransformSpanHook, W as WrapAISDKOptions, H as WrappedAI, J as WrappedAISDK, _ as _resetParentToolContextStorage, K as _resetRaindropCallMetadataStorage, L as _resetWarnedMissingUserId, M as boundedStringify, N as capText, Q as clearParentToolContext, U as createRaindropAISDK, V as currentSpan, X as defaultTransformSpan, Y as enterParentToolContext, Z as eventMetadata, $ as eventMetadataFromChatRequest, a0 as getContextManager, a1 as getCurrentParentToolContext, a2 as getCurrentRaindropCallMetadata, a3 as raindrop, a4 as readRaindropCallMetadataFromArgs, a5 as redactJsonAttributeValue, a6 as redactSecretsInObject, a7 as runWithParentToolContext, a8 as runWithRaindropCallMetadata, a9 as withCurrent } from './index-BCojLiWV.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, D as DEFAULT_MAX_TEXT_FIELD_CHARS, h as DEFAULT_REDACT_ATTRIBUTE_KEYS, i as DEFAULT_SECRET_KEY_NAMES, E as EndSpanArgs, j as EventBuilder, k as EventMetadataOptions, F as FeatureFlagValue, l as FeatureFlags, I as IdentifyInput, O as OtlpAnyValue, m as OtlpSpan, P as ParentToolContext, R as REDACTED_PLACEHOLDER, n as RaindropAISDKClient, o as RaindropAISDKContext, p as RaindropAISDKOptions, q as RaindropCallMetadata, r as RaindropTelemetryIntegration, s as RaindropTelemetryIntegrationOptions, t as RaindropTelemetryOptions, S as SelfDiagnosticsOptions, u as SelfDiagnosticsSignalDefinition, v as SelfDiagnosticsSignalDefinitions, w as SelfDiagnosticsTool, x as SelfDiagnosticsToolInput, y as SelfDiagnosticsToolOptions, z as SelfDiagnosticsToolResult, G as StartSpanArgs, T as TRUNCATION_MARKER, H as TraceSpan, J as TransformSpanHook, W as WrapAISDKOptions, K as WrappedAI, L as WrappedAISDK, _ as _resetParentToolContextStorage, M as _resetRaindropCallMetadataStorage, N as _resetWarnedMissingUserId, Q as boundedStringify, U as capText, V as clearParentToolContext, X as createRaindropAISDK, Y as currentSpan, Z as defaultTransformSpan, $ as enterParentToolContext, a0 as eventMetadata, a1 as eventMetadataFromChatRequest, a2 as getContextManager, a3 as getCurrentParentToolContext, a4 as getCurrentRaindropCallMetadata, a5 as normalizeFeatureFlags, a6 as raindrop, a7 as readRaindropCallMetadataFromArgs, a8 as redactJsonAttributeValue, a9 as redactSecretsInObject, aa as runWithParentToolContext, ab as runWithRaindropCallMetadata, ac as withCurrent } from './index-BQwgg9kQ.js';
 
 declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => {