@raindrop-ai/ai-sdk 0.0.41 → 0.1.0

package/dist/{chunk-3EYXAZ2H.mjs → chunk-ETGFVXYM.mjs}

@@ -1,6 +1,14 @@
 import { AsyncLocalStorage } from 'async_hooks';
 
-// ../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
     };
@@ -2725,6 +2737,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;
   }
   /**
@@ -2939,7 +2965,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);
@@ -2952,7 +2978,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,
+      ...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,
@@ -2961,6 +2991,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) {
@@ -3271,6 +3302,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) {
@@ -3285,6 +3330,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) {
@@ -3597,6 +3646,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);
@@ -3650,6 +3700,7 @@ function createFinalize(params) {
         output,
         model: finalModel,
         properties: patch.properties,
+        featureFlags: patch.featureFlags,
         attachments: patch.attachments,
         isPending: keepEventPending
       }).catch((err) => {
@@ -3881,7 +3932,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);
@@ -4157,6 +4209,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);
@@ -4224,6 +4277,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -4365,6 +4419,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);
@@ -4432,6 +4487,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) => {
@@ -5029,7 +5085,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,
@@ -5037,7 +5093,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) {
@@ -5058,7 +5115,7 @@ function extractNestedTokens(usage, key) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.41"};
+  version: "0.1.0"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -5103,6 +5160,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) {
@@ -5207,7 +5266,8 @@ function createRaindropAISDK(opts) {
         "eventId",
         "eventName",
         "convoId",
-        "properties"
+        "properties",
+        "featureFlags"
       ];
       let context;
       let subagentWrapping;
@@ -5239,6 +5299,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);
       }
@@ -5339,4 +5402,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-BCojLiWV.d.mts → index-CUR4qgwL.d.mts}

@@ -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>;
@@ -563,6 +576,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -839,6 +853,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 +1058,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1051,6 +1068,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1215,6 +1233,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1247,10 +1266,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 +1382,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { eventMetadataFromChatRequest as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type TraceSpan as F, type TransformSpanHook as G, type WrappedAI as H, type IdentifyInput as I, type WrappedAISDK as J, _resetRaindropCallMetadataStorage as K, _resetWarnedMissingUserId as L, boundedStringify as M, capText as N, type OtlpAnyValue as O, type ParentToolContext as P, clearParentToolContext as Q, REDACTED_PLACEHOLDER as R, type SelfDiagnosticsOptions as S, TRUNCATION_MARKER as T, createRaindropAISDK as U, currentSpan as V, type WrapAISDKOptions as W, defaultTransformSpan as X, enterParentToolContext as Y, eventMetadata as Z, _resetParentToolContextStorage as _, type AISDKChatRequestMessageLike as a, getContextManager as a0, getCurrentParentToolContext as a1, getCurrentRaindropCallMetadata as a2, raindrop as a3, readRaindropCallMetadataFromArgs as a4, redactJsonAttributeValue as a5, redactSecretsInObject as a6, runWithParentToolContext as a7, runWithRaindropCallMetadata as a8, withCurrent as a9, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, DEFAULT_REDACT_ATTRIBUTE_KEYS as h, DEFAULT_SECRET_KEY_NAMES as i, type EventBuilder as j, type EventMetadataOptions as k, type OtlpSpan as l, type RaindropAISDKClient as m, type RaindropAISDKContext as n, type RaindropAISDKOptions as o, type RaindropCallMetadata as p, RaindropTelemetryIntegration as q, type RaindropTelemetryIntegrationOptions as r, type RaindropTelemetryOptions as s, type SelfDiagnosticsSignalDefinition as t, type SelfDiagnosticsSignalDefinitions as u, type SelfDiagnosticsTool as v, type SelfDiagnosticsToolInput as w, type SelfDiagnosticsToolOptions as x, type SelfDiagnosticsToolResult as y, type StartSpanArgs as z };
+export { enterParentToolContext as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, type StartSpanArgs as G, type TraceSpan as H, type IdentifyInput as I, type TransformSpanHook as J, type WrappedAI as K, type WrappedAISDK as L, _resetRaindropCallMetadataStorage as M, _resetWarnedMissingUserId as N, type OtlpAnyValue as O, type ParentToolContext as P, boundedStringify as Q, REDACTED_PLACEHOLDER as R, type SelfDiagnosticsOptions as S, TRUNCATION_MARKER as T, capText as U, clearParentToolContext as V, type WrapAISDKOptions as W, createRaindropAISDK as X, currentSpan as Y, defaultTransformSpan as Z, _resetParentToolContextStorage as _, type AISDKChatRequestMessageLike as a, eventMetadata as a0, eventMetadataFromChatRequest as a1, getContextManager as a2, getCurrentParentToolContext as a3, getCurrentRaindropCallMetadata as a4, normalizeFeatureFlags as a5, raindrop as a6, readRaindropCallMetadataFromArgs as a7, redactJsonAttributeValue as a8, redactSecretsInObject as a9, runWithParentToolContext as aa, runWithRaindropCallMetadata as ab, withCurrent as ac, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, DEFAULT_REDACT_ATTRIBUTE_KEYS as h, DEFAULT_SECRET_KEY_NAMES as i, type EventBuilder as j, type EventMetadataOptions as k, type FeatureFlags as l, type OtlpSpan as m, type RaindropAISDKClient as n, type RaindropAISDKContext as o, type RaindropAISDKOptions as p, type RaindropCallMetadata as q, RaindropTelemetryIntegration as r, type RaindropTelemetryIntegrationOptions as s, type RaindropTelemetryOptions as t, type SelfDiagnosticsSignalDefinition as u, type SelfDiagnosticsSignalDefinitions as v, type SelfDiagnosticsTool as w, type SelfDiagnosticsToolInput as x, type SelfDiagnosticsToolOptions as y, type SelfDiagnosticsToolResult as z };

package/dist/{index-BCojLiWV.d.ts → index-CUR4qgwL.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>;
@@ -563,6 +576,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -839,6 +853,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 +1058,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1051,6 +1068,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1215,6 +1233,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1247,10 +1266,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 +1382,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { eventMetadataFromChatRequest as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type TraceSpan as F, type TransformSpanHook as G, type WrappedAI as H, type IdentifyInput as I, type WrappedAISDK as J, _resetRaindropCallMetadataStorage as K, _resetWarnedMissingUserId as L, boundedStringify as M, capText as N, type OtlpAnyValue as O, type ParentToolContext as P, clearParentToolContext as Q, REDACTED_PLACEHOLDER as R, type SelfDiagnosticsOptions as S, TRUNCATION_MARKER as T, createRaindropAISDK as U, currentSpan as V, type WrapAISDKOptions as W, defaultTransformSpan as X, enterParentToolContext as Y, eventMetadata as Z, _resetParentToolContextStorage as _, type AISDKChatRequestMessageLike as a, getContextManager as a0, getCurrentParentToolContext as a1, getCurrentRaindropCallMetadata as a2, raindrop as a3, readRaindropCallMetadataFromArgs as a4, redactJsonAttributeValue as a5, redactSecretsInObject as a6, runWithParentToolContext as a7, runWithRaindropCallMetadata as a8, withCurrent as a9, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, DEFAULT_REDACT_ATTRIBUTE_KEYS as h, DEFAULT_SECRET_KEY_NAMES as i, type EventBuilder as j, type EventMetadataOptions as k, type OtlpSpan as l, type RaindropAISDKClient as m, type RaindropAISDKContext as n, type RaindropAISDKOptions as o, type RaindropCallMetadata as p, RaindropTelemetryIntegration as q, type RaindropTelemetryIntegrationOptions as r, type RaindropTelemetryOptions as s, type SelfDiagnosticsSignalDefinition as t, type SelfDiagnosticsSignalDefinitions as u, type SelfDiagnosticsTool as v, type SelfDiagnosticsToolInput as w, type SelfDiagnosticsToolOptions as x, type SelfDiagnosticsToolResult as y, type StartSpanArgs as z };
+export { enterParentToolContext as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, type StartSpanArgs as G, type TraceSpan as H, type IdentifyInput as I, type TransformSpanHook as J, type WrappedAI as K, type WrappedAISDK as L, _resetRaindropCallMetadataStorage as M, _resetWarnedMissingUserId as N, type OtlpAnyValue as O, type ParentToolContext as P, boundedStringify as Q, REDACTED_PLACEHOLDER as R, type SelfDiagnosticsOptions as S, TRUNCATION_MARKER as T, capText as U, clearParentToolContext as V, type WrapAISDKOptions as W, createRaindropAISDK as X, currentSpan as Y, defaultTransformSpan as Z, _resetParentToolContextStorage as _, type AISDKChatRequestMessageLike as a, eventMetadata as a0, eventMetadataFromChatRequest as a1, getContextManager as a2, getCurrentParentToolContext as a3, getCurrentRaindropCallMetadata as a4, normalizeFeatureFlags as a5, raindrop as a6, readRaindropCallMetadataFromArgs as a7, redactJsonAttributeValue as a8, redactSecretsInObject as a9, runWithParentToolContext as aa, runWithRaindropCallMetadata as ab, withCurrent as ac, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, DEFAULT_REDACT_ATTRIBUTE_KEYS as h, DEFAULT_SECRET_KEY_NAMES as i, type EventBuilder as j, type EventMetadataOptions as k, type FeatureFlags as l, type OtlpSpan as m, type RaindropAISDKClient as n, type RaindropAISDKContext as o, type RaindropAISDKOptions as p, type RaindropCallMetadata as q, RaindropTelemetryIntegration as r, type RaindropTelemetryIntegrationOptions as s, type RaindropTelemetryOptions as t, type SelfDiagnosticsSignalDefinition as u, type SelfDiagnosticsSignalDefinitions as v, type SelfDiagnosticsTool as w, type SelfDiagnosticsToolInput as x, type SelfDiagnosticsToolOptions as y, type SelfDiagnosticsToolResult as z };

package/dist/index.browser.d.mts

@@ -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>;
@@ -563,6 +576,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -839,6 +853,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 +1058,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1051,6 +1068,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1215,6 +1233,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1247,10 +1266,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 +1382,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.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>;
@@ -563,6 +576,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -839,6 +853,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 +1058,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1051,6 +1068,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1215,6 +1233,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1247,10 +1266,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 +1382,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 };